OS.bee documentation - User contributions [en]

OS.bee Software Factory Installation Neon

2017-07-05T20:58:11Z

Hamid: /* Maven Settings */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3'''. Then, click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Setting preferences in ''Eclipse'' ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, otherwise generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations. 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>ds</code> in the filter field and then click on '''DS Annotations'''. 
# Activate the '''Generate descriptors from annotated sources''' checkbox. [[File:NeonOsbeeInstall13.png|600px]] 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>java</code> in the filter field, click on '''Installed JREs''' and then click on '''Search...'''. [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (on Windows it's usually under <code>C:\Program Files\Java\...</code>) and click '''OK'''. [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and click on '''Apply''', then on '''OK'''. [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called '''settings.xml'''. The file is usually expected by ''Eclipse'' to be located in the '''m2''' folder in the user's home folder.

# You can start with the following content of the '''settings.xml''' file (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# Go to ''Eclipse'' '''Preferences''' -> '''Maven''' -> '''User Settings''' and enter the path to the '''settings.xml''' file in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:56:22Z

Hamid: /* Maven Settings */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3'''. Then, click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Setting preferences in ''Eclipse'' ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, otherwise generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations. 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>ds</code> in the filter field and then click on '''DS Annotations'''. 
# Activate the '''Generate descriptors from annotated sources''' checkbox. [[File:NeonOsbeeInstall13.png|600px]] 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>java</code> in the filter field, click on '''Installed JREs''' and then click on '''Search...'''. [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (on Windows it's usually under <code>C:\Program Files\Java\...</code>) and click '''OK'''. [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and click on '''Apply''', then on '''OK'''. [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called '''settings.xml'''. The file is usually expected by ''Eclipse'' to be located in the '''m2''' folder in the user's home folder.

# You can start with the following content of the '''settings.xml''' file(don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:53:11Z

Hamid: /* JDK Settings */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3'''. Then, click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Setting preferences in ''Eclipse'' ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, otherwise generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations. 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>ds</code> in the filter field and then click on '''DS Annotations'''. 
# Activate the '''Generate descriptors from annotated sources''' checkbox. [[File:NeonOsbeeInstall13.png|600px]] 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>java</code> in the filter field, click on '''Installed JREs''' and then click on '''Search...'''. [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (on Windows it's usually under <code>C:\Program Files\Java\...</code>) and click '''OK'''. [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and click on '''Apply''', then on '''OK'''. [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:52:50Z

Hamid: /* JDK Settings */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3'''. Then, click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Setting preferences in ''Eclipse'' ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, otherwise generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations. 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>ds</code> in the filter field and then click on '''DS Annotations'''. 
# Activate the '''Generate descriptors from annotated sources''' checkbox. [[File:NeonOsbeeInstall13.png|600px]] 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>java</code> in the filter field, click on '''Installed JREs''' and then click on '''Search...'''. [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (on Windows it's usually under <code>C:\Program Files\Java\...</code>) and hit '''OK'''. [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and click on '''Apply''', then on '''OK'''. [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:51:48Z

Hamid: /* JDK Settings */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3'''. Then, click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Setting preferences in ''Eclipse'' ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, otherwise generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations. 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>ds</code> in the filter field and then click on '''DS Annotations'''. 
# Activate the '''Generate descriptors from annotated sources''' checkbox. [[File:NeonOsbeeInstall13.png|600px]] 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>java</code> in the filter field, click on '''Installed JREs''' and then click on '''Search...'''. [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program Files\Java\...</code>) and hit '''OK'''. [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and click on '''Apply''', then on '''OK'''. [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:50:12Z

Hamid: /* DS Annotations */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3'''. Then, click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Setting preferences in ''Eclipse'' ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, otherwise generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations. 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>ds</code> in the filter field and then click on '''DS Annotations'''. 
# Activate the '''Generate descriptors from annotated sources''' checkbox. [[File:NeonOsbeeInstall13.png|600px]] 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>java</code> in the filter field, click on '''Installed JREs''' and then click on '''Search...'''. [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:49:43Z

Hamid: /* DS Annotations */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3'''. Then, click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Setting preferences in ''Eclipse'' ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, otherwise generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>ds</code> in the filter field and then click on '''DS Annotations''' 
# Activate the '''Generate descriptors from annotated sources''' checkbox [[File:NeonOsbeeInstall13.png|600px]] 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>java</code> in the filter field, click on '''Installed JREs''' and then click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:47:21Z

Hamid: /* DS Annotations */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3'''. Then, click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Setting preferences in ''Eclipse'' ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, otherwise generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, enter <code>ds</code> in the filter and then click on '''DS Annotations''' 
# Activate the "Generate descriptors from annotated sources" checkbox [[File:NeonOsbeeInstall13.png|600px]] 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, filter for "java", go to '''Installed JREs''' and then click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:44:37Z

Hamid: /* DS Annotations */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3'''. Then, click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Setting preferences in ''Eclipse'' ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, otherwise generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE 
# Activate the "Generate descriptors from annotaded sources" checkbox [[File:NeonOsbeeInstall13.png|600px]] 
# Go to '''Window''' -> '''Preferences''' in your ''Eclipse'' IDE, filter for "java", go to '''Installed JREs''' and then click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:42:20Z

Hamid: /* Git settings */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3'''. Then, click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Setting preferences in ''Eclipse'' ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, otherwise generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:41:19Z

Hamid: /* Set preferences in Eclipse */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3'''. Then, click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Setting preferences in ''Eclipse'' ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:39:49Z

Hamid: /* Set the Target Platform for the OS.bee Software Factory */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3'''. Then, click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:37:05Z

Hamid: /* Set the Target Platform for the OS.bee Software Factory */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter <code>x.a</code> in the filter and deactivate the following bundles in the resulting target definition: '''javax.annotation version 1.2''' '''javax.annotation.source version 1.2''' [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter <code>guava</code> in the filter and deactivate the following bundle in the resulting target definition: '''com.google.guava version 21.0''' [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter <code>antlr</code> in the filter and deactivate the following bundle in the resulting target definition: '''org.antlr.runtime version 4.3''' and click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:31:43Z

Hamid: /* Set the Target Platform for the OS.bee Software Factory */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart ''Eclipse''. You can use '''Menu''' -> '''File''' -> '''Restart''' to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:30:56Z

Hamid: /* Set the Target Platform for the OS.bee Software Factory */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on '''Finish'''. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T20:26:43Z

Hamid: /* Set the Target Platform for the OS.bee Software Factory */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Expand the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T15:57:00Z

Hamid: /* Set the Target Platform for the OS.bee Software Factory */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# For the '''Software Site''', use the same URL that was previously saved to the clipboard. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T15:53:59Z

Hamid: /* Set the Target Platform for the OS.bee Software Factory */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select '''Software Site''' and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T15:48:14Z

Hamid: /* Installation of the OS.bee Software Factory */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Expand the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T15:21:42Z

Hamid: /* Installation of the OS.bee Software Factory */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then, press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T15:21:10Z

Hamid: /* Installation of the OS.bee Software Factory */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the subsequently enabled buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T15:14:39Z

Hamid: /* Eclipse Version */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T15:12:22Z

Hamid: /* Eclipse Version */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a ''Windows'' installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T15:10:44Z

Hamid: /* Eclipse Version */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 ''Eclipse'' Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a ''Windows'' installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T15:08:57Z

Hamid: /* Java Version */

== 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 64-bit Windows systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 Eclipse Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a ''Windows'' installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-05T15:08:26Z

Hamid: /* Java Version */

== 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 64-bit ''Windows'' systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 Eclipse Neon 3 DSL Developers].
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 on the computer's desktop to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a ''Windows'' installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

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

=== License information ===

{{License information}}

OS.bee Software Factory Installation Neon

2017-07-02T22:11:16Z

Hamid: /* Set the Target Platform for the OS.bee Software Factory */

== 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 64-bit ''Windows'' systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 Eclipse Neon 3 DSL Developers].
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 on the computer's desktop a shortcut to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a ''Windows'' installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: '''Menu''' -> '''Window''' -> '''Preferences''' -> '''Plug-in Development''' -> '''Target Platform'''. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

OS.bee Software Factory Installation Neon

2017-07-02T22:09:41Z

Hamid: /* Set the Target Platform for the OS.bee Software Factory */

== 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 64-bit ''Windows'' systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 Eclipse Neon 3 DSL Developers].
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 on the computer's desktop a shortcut to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a ''Windows'' installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: Menu -> Window -> Preferences -> Plug-in Development -> Target Platform. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

OS.bee Software Factory Installation Neon

2017-07-02T22:07:15Z

Hamid: /* Installation of the OS.bee Software Factory */

== 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 64-bit ''Windows'' systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 Eclipse Neon 3 DSL Developers].
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 on the computer's desktop a shortcut to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a ''Windows'' installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the '''OS.bee Software Factory''' group, select the '''OS.bee Software Factory''' and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: Menu -> Window -> Preferences -> Plug-in Development -> Target Platform. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

OS.bee Software Factory Installation Neon

2017-07-02T22:01:22Z

Hamid: /* Installation of the OS.bee Software Factory */

== 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 64-bit ''Windows'' systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 Eclipse Neon 3 DSL Developers].
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 on the computer's desktop a shortcut to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a ''Windows'' installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help''' -> '''Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the ''OS.bee Software Factory'' group, select the <code>OS.bee Software Factory</code> and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: Menu -> Window -> Preferences -> Plug-in Development -> Target Platform. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

OS.bee Software Factory Installation Neon

2017-07-02T21:59:28Z

Hamid: /* Installation of the OS.bee Software Factory */

== 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 64-bit ''Windows'' systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 Eclipse Neon 3 DSL Developers].
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 on the computer's desktop a shortcut to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a ''Windows'' installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select '''Help -> Install New Software...'''. [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make ''Eclipse'' load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the ''OS.bee Software Factory'' group, select the <code>OS.bee Software Factory</code> and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this, just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now begin. This may take a while, depending on your Internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' ''Eclipse''. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: Menu -> Window -> Preferences -> Plug-in Development -> Target Platform. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

OS.bee Software Factory Installation Neon

2017-07-02T21:50:32Z

Hamid: /* Eclipse Version */

== 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 64-bit ''Windows'' systems, 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 Neon'' version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 Eclipse Neon 3 DSL Developers].
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 on the computer's desktop a shortcut to the program '''C:\eclipse\eclipse.exe'''. 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''. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for ''Eclipse'' to use.

A resulting '''eclipse.ini''' file for a ''Windows'' installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select Help -> Install New Software.... [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make Eclipse load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the "OS.bee Software Factory" group, select the "OS.bee Software Factory" and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now start. This may take a while, depending on your internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' Eclipse. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: Menu -> Window -> Preferences -> Plug-in Development -> Target Platform. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

OS.bee Software Factory Installation Neon

2017-07-02T21:44:15Z

Hamid: /* Java Version */

== 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 64-bit ''Windows'' systems, 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 Neon version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 Eclipse Neon 3 DSL Developers].
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. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for Eclipse to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select Help -> Install New Software.... [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make Eclipse load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the "OS.bee Software Factory" group, select the "OS.bee Software Factory" and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now start. This may take a while, depending on your internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' Eclipse. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: Menu -> Window -> Preferences -> Plug-in Development -> Target Platform. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

OS.bee Software Factory Installation Neon

2017-07-02T21:43:57Z

Hamid: /* Java Version */

== 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 64-bit Windows systems, 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 Neon version installed.
You can use [https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/neon/3/eclipse-dsl-neon-3-win32-x86_64.zip&mirror_id=1190 Eclipse Neon 3 DSL Developers].
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. 

Make the following change to the '''eclipse.ini''' file found in the '''C:\eclipse''' folder:
<blockquote>
-Xmx4096m
</blockquote>

This line allocates extra memory for Eclipse to use.

A resulting '''eclipse.ini''' file for a Windows installation might look like this: 
<existing lines above>
-Xms128m
-Xmx4096m

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

'''At the moment, the installation is only possible if you have access to the internal network. Use this --> [http://ccngiw2.compex.de/downloads/p2/osbee/neon/latest/ link] directly in Eclipse.'''

=== 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. [[File:Workspace1.png|600px]] 
# Go to the menu bar and select Help -> Install New Software.... [[File:NeonOsbeeInstall01.png|600px]] 
# Get the link to the repository from the [http://www.osbee.org/free-download/ download page], activate the checkbox if you agree to our '''Terms of Service and Use''' and if you '''are not a consumer'''. Click on one of the then activated buttons, copy the link and paste it into the field labeled '''Work with:'''. Then press '''Enter''' to make Eclipse load the content of the repository. [[File:OSbeeInstall05.PNG|600px]] 
# Open the "OS.bee Software Factory" group, select the "OS.bee Software Factory" and click on '''Next'''. [[File:NeonOsbeeInstall02.png|600px]] 
# If during installation you encounter this just hit '''Next'''. [[File:NeonOsbeeInstall99.png|600px]] 
# In the installation dialog, confirm the software to be installed by clicking on '''Next'''. [[File:NeonOsbeeInstall03.png|600px]] 
# Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on '''Finish'''. [[File:NeonOsbeeInstall04.png|600px]] 
# The installation will now start. This may take a while, depending on your internet connection speed. [[File:NeonOsbeeInstall05.png|600px]] 
# After the software has been downloaded, confirm the "Security Warning" dialog by clicking on '''OK'''. [[File:InstallUnsignedCodeWarning.png|600px]] 
# You will then be prompted to '''restart''' Eclipse. Please do so. [[File:NeonOsbeeInstall06.png|600px]] 

=== 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. 
# Set the target platform here: Menu -> Window -> Preferences -> Plug-in Development -> Target Platform. 
# Click on '''Add...''' to add a new target definition. [[File:NeonOsbeeInstall07.png|600px]] 
# Select "Default: ..." and click on '''Next'''. [[File:NeonOsbeeInstall08.png|600px]] 
# Click on '''Add...''' to add content, select "Software Site" and click on '''Next'''. [[File:NeonOsbeeInstall09.png|600px]] 
# Use the same URL previously saved to the clipboard for the Software Site. 
# Open the group '''OS.bee Softwarefactory''', select '''OS.bee Softwarefactory Targetplatform (DON'T INSTALL...)''', '''uncheck''' the '''Include required software''' checkbox and click on '''Finish'''. [[File:NeonOsbeeInstall10.png|600px]] 
# Change to register '''Content''' 
#* Enter '''x.a''' in the filter and deactivate the following bundles in the resulting target definition: <code>javax.annotation version 1.2 javax.annotation.source version 1.2</code> [[File:NeonOsbeeInstall11.png|600px]] 
#* Enter '''guava''' in the filter and deactivate the following bundle in the resulting target definition: <code>com.google.guava version 21.0</code> [[File:NeonOsbeeInstall17.png|600px]] 
#* Enter '''antlr''' in the filter and deactivate the following bundle in the resulting target definition: <code>org.antlr.runtime version 4.3</code> and click on finish. [[File:NeonOsbeeInstall18.png|600px]] 
# '''Do not forget to activate your newly created target definition! ''' [[File:NeonOsbeeInstall12.png|600px]] 
# Restart Eclipse. You can use Menu -> File -> Restart to do so. 

=== Set preferences in Eclipse ===
==== Git settings ====
Be sure to uncheck the automatic git-ignore for derived files, else generated files will not be checked in:
 [[File:Git-Preferences.png|600px]] 

==== DS Annotations ====
# It is neccessary to activate the generation of descriptors based on DS Annotations 
# Go to Window / Preferences in your Eclipse IDE 
# Activate the "Generate descriptors from annotaded sources" [[File:NeonOsbeeInstall13.png|600px]] 
# Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to '''Installed JREs''' and click on '''Search...''' [[File:NeonOsbeeInstall14.png|600px]] 

==== JDK Settings ====
# Locate your JDK (On Windows it's usually under <code>C:\Program FIles\Java\...</code>) and hit '''OK''' [[File:NeonOsbeeInstall15.png|600px]] 
# Select the newly added JDK and hit '''Apply''', then '''OK''' [[File:NeonOsbeeInstall16.png|600px]] 

==== Maven Settings ====

'''For developers only!'''

Maven requires some settings in a file called <code>settings.xml</code>. The file is usually expected by Eclipse to be located in the .m2 directory in the Users home directory.

# You can start with the following content of the settings.xml (don't forget to replace the '''xxxx''' with the appropriate repo names):<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

<localRepository>c:/maven/.m2/repository</localRepository>

<mirrors>



<mirror>
<id>Apache Mirror</id>
<mirrorOf>apache-nexus-snapshots</mirrorOf>
<url>http://www-eu.apache.org/dist/</url>
</mirror>

</mirrors>


<profiles>

<profile>
<id>osbp-dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<osbp.build.ignore.license>false</osbp.build.ignore.license>
<osbp.build.verbose.license>true</osbp.build.verbose.license>

<osbp.skip.javadoc>false</osbp.skip.javadoc>
<osbp.javadoc.failOnError>false</osbp.javadoc.failOnError>

<osbp.skip.test>true</osbp.skip.test>

<osbp.build.branch>latest</osbp.build.branch>
<osbp.developer.home>C:${file.separator}osbee${file.separator}downloads${file.separator}</osbp.developer.home>

<osbee.build.ignore.license>false</osbee.build.ignore.license>
<osbee.build.verbose.license>true</osbee.build.verbose.license>

<osbee.developer.home>${osbp.developer.home}</osbee.developer.home>
<osbee.build.branch>${osbp.build.branch}</osbee.build.branch>

<distribution.server.baseurl>http://my.own.nexus.local</distribution.server.baseurl>

<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>

<distribution.repository.snapshot.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-snapshots/</distribution.repository.snapshot.url>
<osbp.p2>http://download.osbee.org/downloads/p2/osbp/neon/xxxx</osbp.p2>
<org.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</org.osbee.p2>
<net.osbee.p2>http://download.osbee.org/downloads/p2/osbee/neon/xxxx</net.osbee.p2>

<osbee.helpdesk.product.download.folder>${osbp.developer.home}products${file.separator}helpdesk</osbee.helpdesk.product.download.folder>

</properties>

<pluginRepositories>
<pluginRepository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>compex-snapshots</id>
<name>Compex Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>

<repositories>
<repository>
<id>compex-nexus-snapshots</id>
<name>Compex Nexus Snapshots</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-snapshots/
</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<updatePolicy>always</updatePolicy>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>compex-nexus-release</id>
<name>Compex Nexus Release</name>
<url>http://download.osbee.org:8086/nexus/content/repositories/osbp-master-clean-releases/
</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>

<repository>
<id>Compex Internal P2 OSbee</id>

<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
</url>
<layout>p2</layout>
</repository>
</repositories>
</profile>
</profiles>

</settings></syntaxhighlight>
# go to the Eclipse preferences / Maven / User Settings and enter the path to the settings.xml in the '''User settings''' section.

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

OS.bee used licenses

2017-07-02T16:43:16Z

Hamid: /* OS.bee used licenses */

==OS.bee Used Licenses==

The ''OS.bee Software Factory'' is based on the ''OSBP Software Factory'' which has been certified as an ''Eclipse'' project.

''The OSBP Software Factory'' is based on many other open-source projects. The licenses of these projects are listed [http://download.osbee.org/downloads/licenses/osbee/daily/osbee-used-lics.html here].

An overview of the bundles installed and their corresponding license(s) can be found [http://download.osbee.org/downloads/licenses/osbee/daily/osbee-used-bundles.html here].

OS.bee API Documentation

2017-07-02T16:41:15Z

Hamid:

The OS.bee API Documentation can be found on the download server in ''javadoc'' format. It is automatically updated by the build process and deployed together with the build.

Please follow the [http://download.osbee.org/downloads/javadoc/osbee-master-clean/ link]

OS.bee Software Factory Release Notes

2017-07-02T16:39:28Z

Hamid: /* Release 1.0 */

=OS.bee Software Factory Release Notes=

== Release 1.0 ==

Released: 01. Dec. 2016

Initial public version of the ''OS.bee Software Factory''.

OS.bee Software Factory Release Notes

2017-07-02T16:39:10Z

Hamid: /* Release 1.0 */

=OS.bee Software Factory Release Notes=

== Release 1.0 ==

Released: 01. Dec. 2016

Initial Public Version of the ''OS.bee Software Factory''.

OS.bee Software Factory Documentation

2017-07-02T16:38:03Z

Hamid: /* OS.bee Third-Party Software Solutions */

=OS.bee DSL Documentation=
The ''OS.bee Software Factory'' is composed of various domain specific languages (DSLs), which are described in detail on the following pages.

==[[Entity DSL]]==
The [[Entity DSL]] is, beside Datatypes, the basic DSL for the Software Factory. It allows you, through the creation of entity model files, to describe the entity relationship models that will be used to create, read, update and delete content on a persistence level, such as with an SQL database.

==[[DTO DSL]]==
The [[DTO DSL]] handles data transfer objects in order to transfer data between processes. It uses the [[Entity DSL]].

==[[Chart DSL]]==
The [[Chart DSL]] provides Vaadin dCharts.

==[[Cube DSL]]==
The [[Cube DSL]] provides MDX access to Mondrian OLAP Cubes.

==[[Datamart DSL]]==
A datamart is a condensed and more focused version of a data warehouse that reflects the regulations and process specifications of each business unit within an organization. Each datamart is dedicated to a specific business function or region.

==[[Dialog DSL]]==
The [[Dialog DSL]] generates the [https://vaadin.com/home Vaadin] UI

==[[Report DSL]]==
The [[Report DSL]] generates the [https://vaadin.com/home Vaadin] UI and the [http://developer.actuate.com/about/ BIRT] report module.

==[[Table DSL ]]==
The [[Table DSL]] generates the [https://vaadin.com/home Vaadin] table UI.

==[[Topology DSL ]]==
The [[Topology DSL]] generates [https://d3js.org/ D3.js], a JavaScript library for manipulating documents based on data, to generate the visualization of topology charts. Data used is [https://github.com/topojson topojson], an extension of [http://geojson.org/ GeoJSON] that encodes topology and the corresponding UI components.

==[[Entitymock DSL]]==
The [[Entitymock DSL]] generates mock data for entity models automatically upon initialization.

==[[Statemachine DSL]]==
The [[Statemachine DSL]] adds behavior to user interfaces. Instances of this DSL interconnect UI instances, FunctionLibrary instances, persistence layers and peripheral devices, and therefore act as controllers in a multiple Model-View-Controller environment. There is no limitation of how many statemachine instances control a single business application.

==[[Authorization DSL]]==

==[[Organization DSL]]==

==[[Topology DSL]]==

==[[Perspective DSL]]==

==[[How to add pictures]]==

=OS.bee-Specific DSL Instances=
The ''OS.bee Software Factory'' provides a few specific DSL instances for different requirements. These are described in detail on the following pages.

==Datatypes==
Several custom datatypes are described in detail in this chapter.
===[[BlobMapping]]===
This datatype allows the use of big data as a blob.

=Other OS.bee-Specific Solutions=
The ''OS.bee Software Factory'' also provides other solutions, which are described in detail on the following pages.

==[[Themes]]==

=OS.bee Third-Party Software Solutions=
OS.bee also uses products of other software vendors (third-party products) that are based on open-source products.

==[[Peripheral Devices]]==

OS.bee Software Factory Documentation

2017-07-02T16:37:10Z

Hamid: /* How to Add Pictures */

OS.bee Software Factory Documentation

2017-07-02T16:36:50Z

Hamid: /* How to add pictures */

=OS.bee DSL Documentation=
The ''OS.bee Software Factory'' is composed of various domain specific languages (DSLs), which are described in detail on the following pages.

==[[Entity DSL]]==
The [[Entity DSL]] is, beside Datatypes, the basic DSL for the Software Factory. It allows you, through the creation of entity model files, to describe the entity relationship models that will be used to create, read, update and delete content on a persistence level, such as with an SQL database.

==[[DTO DSL]]==
The [[DTO DSL]] handles data transfer objects in order to transfer data between processes. It uses the [[Entity DSL]].

==[[Chart DSL]]==
The [[Chart DSL]] provides Vaadin dCharts.

==[[Cube DSL]]==
The [[Cube DSL]] provides MDX access to Mondrian OLAP Cubes.

==[[Datamart DSL]]==
A datamart is a condensed and more focused version of a data warehouse that reflects the regulations and process specifications of each business unit within an organization. Each datamart is dedicated to a specific business function or region.

==[[Dialog DSL]]==
The [[Dialog DSL]] generates the [https://vaadin.com/home Vaadin] UI

==[[Report DSL]]==
The [[Report DSL]] generates the [https://vaadin.com/home Vaadin] UI and the [http://developer.actuate.com/about/ BIRT] report module.

==[[Table DSL ]]==
The [[Table DSL]] generates the [https://vaadin.com/home Vaadin] table UI.

==[[Topology DSL ]]==
The [[Topology DSL]] generates [https://d3js.org/ D3.js], a JavaScript library for manipulating documents based on data, to generate the visualization of topology charts. Data used is [https://github.com/topojson topojson], an extension of [http://geojson.org/ GeoJSON] that encodes topology and the corresponding UI components.

==[[Entitymock DSL]]==
The [[Entitymock DSL]] generates mock data for entity models automatically upon initialization.

==[[Statemachine DSL]]==
The [[Statemachine DSL]] adds behavior to user interfaces. Instances of this DSL interconnect UI instances, FunctionLibrary instances, persistence layers and peripheral devices, and therefore act as controllers in a multiple Model-View-Controller environment. There is no limitation of how many statemachine instances control a single business application.

==[[Authorization DSL]]==

==[[Organization DSL]]==

==[[Topology DSL]]==

==[[Perspective DSL]]==

==[[How to Add Pictures]]==

=OS.bee-Specific DSL Instances=
The ''OS.bee Software Factory'' provides a few specific DSL instances for different requirements. These are described in detail on the following pages.

==Datatypes==
Several custom datatypes are described in detail in this chapter.
===[[BlobMapping]]===
This datatype allows the use of big data as a blob.

=Other OS.bee-Specific Solutions=
The ''OS.bee Software Factory'' also provides other solutions, which are described in detail on the following pages.

==[[Themes]]==

=OS.bee Third-Party Software Solutions=
OS.bee also uses products of other software vendors (third-party products) that are based on open source products.

==[[Peripheral Devices]]==

OS.bee Software Factory Documentation

2017-07-02T16:35:35Z

Hamid: /* Report DSL */

OS.bee Software Factory Documentation

2017-07-02T16:34:27Z

Hamid: /* Datamart DSL */

=OS.bee DSL Documentation=
The ''OS.bee Software Factory'' is composed of various domain specific languages (DSLs), which are described in detail on the following pages.

==[[Entity DSL]]==
The [[Entity DSL]] is, beside Datatypes, the basic DSL for the Software Factory. It allows you, through the creation of entity model files, to describe the entity relationship models that will be used to create, read, update and delete content on a persistence level, such as with an SQL database.

==[[DTO DSL]]==
The [[DTO DSL]] handles data transfer objects in order to transfer data between processes. It uses the [[Entity DSL]].

==[[Chart DSL]]==
The [[Chart DSL]] provides Vaadin dCharts.

==[[Cube DSL]]==
The [[Cube DSL]] provides MDX access to Mondrian OLAP Cubes.

==[[Datamart DSL]]==
A datamart is a condensed and more focused version of a data warehouse that reflects the regulations and process specifications of each business unit within an organization. Each datamart is dedicated to a specific business function or region.

==[[Dialog DSL]]==
The [[Dialog DSL]] generates the [https://vaadin.com/home Vaadin] UI

==[[Report DSL]]==
The [[Report DSL]] generates the [https://vaadin.com/home Vaadin] ui and [http://developer.actuate.com/about/ BIRT] report.

==[[Table DSL ]]==
The [[Table DSL]] generates the [https://vaadin.com/home Vaadin] table UI.

==[[Topology DSL ]]==
The [[Topology DSL]] generates [https://d3js.org/ D3.js], a JavaScript library for manipulating documents based on data, to generate the visualization of topology charts. Data used is [https://github.com/topojson topojson], an extension of [http://geojson.org/ GeoJSON] that encodes topology and the corresponding UI components.

==[[Entitymock DSL]]==
The [[Entitymock DSL]] generates mock data for entity models automatically upon initialization.

==[[Statemachine DSL]]==
The [[Statemachine DSL]] adds behavior to user interfaces. Instances of this DSL interconnect UI instances, FunctionLibrary instances, persistence layers and peripheral devices, and therefore act as controllers in a multiple Model-View-Controller environment. There is no limitation of how many statemachine instances control a single business application.

==[[Authorization DSL]]==

==[[Organization DSL]]==

==[[Topology DSL]]==

==[[Perspective DSL]]==

==[[How to add pictures]]==

=OS.bee-Specific DSL Instances=
The ''OS.bee Software Factory'' provides a few specific DSL instances for different requirements. These are described in detail on the following pages.

==Datatypes==
Several custom datatypes are described in detail in this chapter.
===[[BlobMapping]]===
This datatype allows the use of big data as a blob.

=Other OS.bee-Specific Solutions=
The ''OS.bee Software Factory'' also provides other solutions, which are described in detail on the following pages.

==[[Themes]]==

=OS.bee Third-Party Software Solutions=
OS.bee also uses products of other software vendors (third-party products) that are based on open source products.

==[[Peripheral Devices]]==

OS.bee Software Factory Documentation

2017-07-02T16:33:09Z

Hamid: /* OS.bee third party software solutions */

=OS.bee DSL Documentation=
The ''OS.bee Software Factory'' is composed of various domain specific languages (DSLs), which are described in detail on the following pages.

==[[Entity DSL]]==
The [[Entity DSL]] is, beside Datatypes, the basic DSL for the Software Factory. It allows you, through the creation of entity model files, to describe the entity relationship models that will be used to create, read, update and delete content on a persistence level, such as with an SQL database.

==[[DTO DSL]]==
The [[DTO DSL]] handles data transfer objects in order to transfer data between processes. It uses the [[Entity DSL]].

==[[Chart DSL]]==
The [[Chart DSL]] provides Vaadin dCharts.

==[[Cube DSL]]==
The [[Cube DSL]] provides MDX access to Mondrian OLAP Cubes.

==[[Datamart DSL]]==
A datamart is a condensed and more focused version of a data warehouse that reflects the regulations and process specifications of each business unit within an organization. Each datamart is dedicated to a specific business function or region.

==[[Dialog DSL]]==
The [[Dialog DSL]] generates the [https://vaadin.com/home Vaadin] UI

==[[Report DSL]]==
The [[Report DSL]] generates the [https://vaadin.com/home Vaadin] ui and [http://developer.actuate.com/about/ BIRT] report.

==[[Table DSL ]]==
The [[Table DSL]] generates the [https://vaadin.com/home Vaadin] table UI.

==[[Topology DSL ]]==
The [[Topology DSL]] generates [https://d3js.org/ D3.js], a JavaScript library for manipulating documents based on data, to generate the visualization of topology charts. Data used is [https://github.com/topojson topojson], an extension of [http://geojson.org/ GeoJSON] that encodes topology and the corresponding UI components.

==[[Entitymock DSL]]==
The [[Entitymock DSL]] generates mock data for entity models automatically upon initialization.

==[[Statemachine DSL]]==
The [[Statemachine DSL]] adds behavior to user interfaces. Instances of this DSL interconnect UI instances, FunctionLibrary instances, persistence layers and peripheral devices, and therefore act as controllers in a multiple Model-View-Controller environment. There is no limitation of how many statemachine instances control a single business application.

==[[Authorization DSL]]==

==[[Organization DSL]]==

==[[Topology DSL]]==

==[[Perspective DSL]]==

==[[How to add pictures]]==

=OS.bee-Specific DSL Instances=
The ''OS.bee Software Factory'' provides a few specific DSL instances for different requirements. These are described in detail on the following pages.

==Datatypes==
Several custom datatypes are described in detail in this chapter.
===[[BlobMapping]]===
This datatype allows the use of big data as a blob.

=Other OS.bee-Specific Solutions=
The ''OS.bee Software Factory'' also provides other solutions, which are described in detail on the following pages.

==[[Themes]]==

=OS.bee Third-Party Software Solutions=
OS.bee also uses products of other software vendors (third-party products) that are based on open source products.

==[[Peripheral Devices]]==

OS.bee Software Factory Documentation

2017-07-02T16:32:02Z

Hamid: /* OS.bee DSL Documentation */

=OS.bee DSL Documentation=
The ''OS.bee Software Factory'' is composed of various domain specific languages (DSLs), which are described in detail on the following pages.

==[[Entity DSL]]==
The [[Entity DSL]] is, beside Datatypes, the basic DSL for the Software Factory. It allows you, through the creation of entity model files, to describe the entity relationship models that will be used to create, read, update and delete content on a persistence level, such as with an SQL database.

==[[DTO DSL]]==
The [[DTO DSL]] handles data transfer objects in order to transfer data between processes. It uses the [[Entity DSL]].

==[[Chart DSL]]==
The [[Chart DSL]] provides Vaadin dCharts.

==[[Cube DSL]]==
The [[Cube DSL]] provides MDX access to Mondrian OLAP Cubes.

==[[Datamart DSL]]==
A datamart is a condensed and more focused version of a data warehouse that reflects the regulations and process specifications of each business unit within an organization. Each datamart is dedicated to a specific business function or region.

==[[Dialog DSL]]==
The [[Dialog DSL]] generates the [https://vaadin.com/home Vaadin] UI

==[[Report DSL]]==
The [[Report DSL]] generates the [https://vaadin.com/home Vaadin] ui and [http://developer.actuate.com/about/ BIRT] report.

==[[Table DSL ]]==
The [[Table DSL]] generates the [https://vaadin.com/home Vaadin] table UI.

==[[Topology DSL ]]==
The [[Topology DSL]] generates [https://d3js.org/ D3.js], a JavaScript library for manipulating documents based on data, to generate the visualization of topology charts. Data used is [https://github.com/topojson topojson], an extension of [http://geojson.org/ GeoJSON] that encodes topology and the corresponding UI components.

==[[Entitymock DSL]]==
The [[Entitymock DSL]] generates mock data for entity models automatically upon initialization.

==[[Statemachine DSL]]==
The [[Statemachine DSL]] adds behavior to user interfaces. Instances of this DSL interconnect UI instances, FunctionLibrary instances, persistence layers and peripheral devices, and therefore act as controllers in a multiple Model-View-Controller environment. There is no limitation of how many statemachine instances control a single business application.

==[[Authorization DSL]]==

==[[Organization DSL]]==

==[[Topology DSL]]==

==[[Perspective DSL]]==

==[[How to add pictures]]==

=OS.bee-Specific DSL Instances=
The ''OS.bee Software Factory'' provides a few specific DSL instances for different requirements. These are described in detail on the following pages.

==Datatypes==
Several custom datatypes are described in detail in this chapter.
===[[BlobMapping]]===
This datatype allows the use of big data as a blob.

=Other OS.bee-Specific Solutions=
The ''OS.bee Software Factory'' also provides other solutions, which are described in detail on the following pages.

==[[Themes]]==

=OS.bee third party software solutions=
OS.bee also uses products of other software vendors (third party) that found on open source products.

==[[Peripheral Devices]]==

OS.bee Software Factory Documentation

2017-07-02T16:31:32Z

Hamid: /* OS.bee DSL Documentation */

=OS.bee DSL Documentation=
The ''OS.bee Software Factory'' is composed of various domain specific languages (DSL) which will be described in detail on the following pages.

==[[Entity DSL]]==
The [[Entity DSL]] is, beside Datatypes, the basic DSL for the Software Factory. It allows you, through the creation of entity model files, to describe the entity relationship models that will be used to create, read, update and delete content on a persistence level, such as with an SQL database.

==[[DTO DSL]]==
The [[DTO DSL]] handles data transfer objects in order to transfer data between processes. It uses the [[Entity DSL]].

==[[Chart DSL]]==
The [[Chart DSL]] provides Vaadin dCharts.

==[[Cube DSL]]==
The [[Cube DSL]] provides MDX access to Mondrian OLAP Cubes.

==[[Datamart DSL]]==
A datamart is a condensed and more focused version of a data warehouse that reflects the regulations and process specifications of each business unit within an organization. Each datamart is dedicated to a specific business function or region.

==[[Dialog DSL]]==
The [[Dialog DSL]] generates the [https://vaadin.com/home Vaadin] UI

==[[Report DSL]]==
The [[Report DSL]] generates the [https://vaadin.com/home Vaadin] ui and [http://developer.actuate.com/about/ BIRT] report.

==[[Table DSL ]]==
The [[Table DSL]] generates the [https://vaadin.com/home Vaadin] table UI.

==[[Topology DSL ]]==
The [[Topology DSL]] generates [https://d3js.org/ D3.js], a JavaScript library for manipulating documents based on data, to generate the visualization of topology charts. Data used is [https://github.com/topojson topojson], an extension of [http://geojson.org/ GeoJSON] that encodes topology and the corresponding UI components.

==[[Entitymock DSL]]==
The [[Entitymock DSL]] generates mock data for entity models automatically upon initialization.

==[[Statemachine DSL]]==
The [[Statemachine DSL]] adds behavior to user interfaces. Instances of this DSL interconnect UI instances, FunctionLibrary instances, persistence layers and peripheral devices, and therefore act as controllers in a multiple Model-View-Controller environment. There is no limitation of how many statemachine instances control a single business application.

==[[Authorization DSL]]==

==[[Organization DSL]]==

==[[Topology DSL]]==

==[[Perspective DSL]]==

==[[How to add pictures]]==

=OS.bee-Specific DSL Instances=
The ''OS.bee Software Factory'' provides a few specific DSL instances for different requirements. These are described in detail on the following pages.

==Datatypes==
Several custom datatypes are described in detail in this chapter.
===[[BlobMapping]]===
This datatype allows the use of big data as a blob.

=Other OS.bee-Specific Solutions=
The ''OS.bee Software Factory'' also provides other solutions, which are described in detail on the following pages.

==[[Themes]]==

=OS.bee third party software solutions=
OS.bee also uses products of other software vendors (third party) that found on open source products.

==[[Peripheral Devices]]==

OS.bee Software Factory Documentation

2017-07-02T16:31:11Z

Hamid: /* OS.bee-Specific DSL Instances */

=OS.bee DSL Documentation=
The OS.bee Software Factory is composed of various domain specific languages (DSL) which will be described in detail on the following pages.

==[[Entity DSL]]==
The [[Entity DSL]] is, beside Datatypes, the basic DSL for the Software Factory. It allows you, through the creation of entity model files, to describe the entity relationship models that will be used to create, read, update and delete content on a persistence level, such as with an SQL database.

==[[DTO DSL]]==
The [[DTO DSL]] handles data transfer objects in order to transfer data between processes. It uses the [[Entity DSL]].

==[[Chart DSL]]==
The [[Chart DSL]] provides Vaadin dCharts.

==[[Cube DSL]]==
The [[Cube DSL]] provides MDX access to Mondrian OLAP Cubes.

==[[Datamart DSL]]==
A datamart is a condensed and more focused version of a data warehouse that reflects the regulations and process specifications of each business unit within an organization. Each datamart is dedicated to a specific business function or region.

==[[Dialog DSL]]==
The [[Dialog DSL]] generates the [https://vaadin.com/home Vaadin] UI

==[[Report DSL]]==
The [[Report DSL]] generates the [https://vaadin.com/home Vaadin] ui and [http://developer.actuate.com/about/ BIRT] report.

==[[Table DSL ]]==
The [[Table DSL]] generates the [https://vaadin.com/home Vaadin] table UI.

==[[Topology DSL ]]==
The [[Topology DSL]] generates [https://d3js.org/ D3.js], a JavaScript library for manipulating documents based on data, to generate the visualization of topology charts. Data used is [https://github.com/topojson topojson], an extension of [http://geojson.org/ GeoJSON] that encodes topology and the corresponding UI components.

==[[Entitymock DSL]]==
The [[Entitymock DSL]] generates mock data for entity models automatically upon initialization.

==[[Statemachine DSL]]==
The [[Statemachine DSL]] adds behavior to user interfaces. Instances of this DSL interconnect UI instances, FunctionLibrary instances, persistence layers and peripheral devices, and therefore act as controllers in a multiple Model-View-Controller environment. There is no limitation of how many statemachine instances control a single business application.

==[[Authorization DSL]]==

==[[Organization DSL]]==

==[[Topology DSL]]==

==[[Perspective DSL]]==

==[[How to add pictures]]==

=OS.bee-Specific DSL Instances=
The ''OS.bee Software Factory'' provides a few specific DSL instances for different requirements. These are described in detail on the following pages.

==Datatypes==
Several custom datatypes are described in detail in this chapter.
===[[BlobMapping]]===
This datatype allows the use of big data as a blob.

=Other OS.bee-Specific Solutions=
The ''OS.bee Software Factory'' also provides other solutions, which are described in detail on the following pages.

==[[Themes]]==

=OS.bee third party software solutions=
OS.bee also uses products of other software vendors (third party) that found on open source products.

==[[Peripheral Devices]]==

OS.bee Software Factory Documentation

2017-07-02T16:30:58Z

Hamid: /* OS.bee specific DSL instances */

=OS.bee DSL Documentation=
The OS.bee Software Factory is composed of various domain specific languages (DSL) which will be described in detail on the following pages.

==[[Entity DSL]]==
The [[Entity DSL]] is, beside Datatypes, the basic DSL for the Software Factory. It allows you, through the creation of entity model files, to describe the entity relationship models that will be used to create, read, update and delete content on a persistence level, such as with an SQL database.

==[[DTO DSL]]==
The [[DTO DSL]] handles data transfer objects in order to transfer data between processes. It uses the [[Entity DSL]].

==[[Chart DSL]]==
The [[Chart DSL]] provides Vaadin dCharts.

==[[Cube DSL]]==
The [[Cube DSL]] provides MDX access to Mondrian OLAP Cubes.

==[[Datamart DSL]]==
A datamart is a condensed and more focused version of a data warehouse that reflects the regulations and process specifications of each business unit within an organization. Each datamart is dedicated to a specific business function or region.

==[[Dialog DSL]]==
The [[Dialog DSL]] generates the [https://vaadin.com/home Vaadin] UI

==[[Report DSL]]==
The [[Report DSL]] generates the [https://vaadin.com/home Vaadin] ui and [http://developer.actuate.com/about/ BIRT] report.

==[[Table DSL ]]==
The [[Table DSL]] generates the [https://vaadin.com/home Vaadin] table UI.

==[[Topology DSL ]]==
The [[Topology DSL]] generates [https://d3js.org/ D3.js], a JavaScript library for manipulating documents based on data, to generate the visualization of topology charts. Data used is [https://github.com/topojson topojson], an extension of [http://geojson.org/ GeoJSON] that encodes topology and the corresponding UI components.

==[[Entitymock DSL]]==
The [[Entitymock DSL]] generates mock data for entity models automatically upon initialization.

==[[Statemachine DSL]]==
The [[Statemachine DSL]] adds behavior to user interfaces. Instances of this DSL interconnect UI instances, FunctionLibrary instances, persistence layers and peripheral devices, and therefore act as controllers in a multiple Model-View-Controller environment. There is no limitation of how many statemachine instances control a single business application.

==[[Authorization DSL]]==

==[[Organization DSL]]==

==[[Topology DSL]]==

==[[Perspective DSL]]==

==[[How to add pictures]]==

=OS.bee-Specific DSL Instances=
The OS.bee Software Factory provides a few specific DSL instances for different requirements. These are described in detail on the following pages.

==Datatypes==
Several custom datatypes are described in detail in this chapter.
===[[BlobMapping]]===
This datatype allows the use of big data as a blob.

=Other OS.bee-Specific Solutions=
The ''OS.bee Software Factory'' also provides other solutions, which are described in detail on the following pages.

==[[Themes]]==

=OS.bee third party software solutions=
OS.bee also uses products of other software vendors (third party) that found on open source products.

==[[Peripheral Devices]]==

OS.bee Software Factory Documentation

2017-07-02T16:30:27Z

Hamid: /* Other OS.bee specific solutions */

=OS.bee DSL Documentation=
The OS.bee Software Factory is composed of various domain specific languages (DSL) which will be described in detail on the following pages.

==[[Entity DSL]]==
The [[Entity DSL]] is, beside Datatypes, the basic DSL for the Software Factory. It allows you, through the creation of entity model files, to describe the entity relationship models that will be used to create, read, update and delete content on a persistence level, such as with an SQL database.

==[[DTO DSL]]==
The [[DTO DSL]] handles data transfer objects in order to transfer data between processes. It uses the [[Entity DSL]].

==[[Chart DSL]]==
The [[Chart DSL]] provides Vaadin dCharts.

==[[Cube DSL]]==
The [[Cube DSL]] provides MDX access to Mondrian OLAP Cubes.

==[[Datamart DSL]]==
A datamart is a condensed and more focused version of a data warehouse that reflects the regulations and process specifications of each business unit within an organization. Each datamart is dedicated to a specific business function or region.

==[[Dialog DSL]]==
The [[Dialog DSL]] generates the [https://vaadin.com/home Vaadin] UI

==[[Report DSL]]==
The [[Report DSL]] generates the [https://vaadin.com/home Vaadin] ui and [http://developer.actuate.com/about/ BIRT] report.

==[[Table DSL ]]==
The [[Table DSL]] generates the [https://vaadin.com/home Vaadin] table UI.

==[[Topology DSL ]]==
The [[Topology DSL]] generates [https://d3js.org/ D3.js], a JavaScript library for manipulating documents based on data, to generate the visualization of topology charts. Data used is [https://github.com/topojson topojson], an extension of [http://geojson.org/ GeoJSON] that encodes topology and the corresponding UI components.

==[[Entitymock DSL]]==
The [[Entitymock DSL]] generates mock data for entity models automatically upon initialization.

==[[Statemachine DSL]]==
The [[Statemachine DSL]] adds behavior to user interfaces. Instances of this DSL interconnect UI instances, FunctionLibrary instances, persistence layers and peripheral devices, and therefore act as controllers in a multiple Model-View-Controller environment. There is no limitation of how many statemachine instances control a single business application.

==[[Authorization DSL]]==

==[[Organization DSL]]==

==[[Topology DSL]]==

==[[Perspective DSL]]==

==[[How to add pictures]]==

=OS.bee specific DSL instances=
The OS.bee Software Factory provides a few specific DSL instances for different requirements. These are described in detail on the following pages.

==Datatypes==
Several custom datatypes are described in detail in this chapter.
===[[BlobMapping]]===
This datatype allows the use of big data as a blob.

=Other OS.bee-Specific Solutions=
The ''OS.bee Software Factory'' also provides other solutions, which are described in detail on the following pages.

==[[Themes]]==

=OS.bee third party software solutions=
OS.bee also uses products of other software vendors (third party) that found on open source products.

==[[Peripheral Devices]]==

OS.bee Software Factory Documentation

2017-07-02T16:29:17Z

Hamid: /* Datatypes */

=OS.bee DSL Documentation=
The OS.bee Software Factory is composed of various domain specific languages (DSL) which will be described in detail on the following pages.

==[[Entity DSL]]==
The [[Entity DSL]] is, beside Datatypes, the basic DSL for the Software Factory. It allows you, through the creation of entity model files, to describe the entity relationship models that will be used to create, read, update and delete content on a persistence level, such as with an SQL database.

==[[DTO DSL]]==
The [[DTO DSL]] handles data transfer objects in order to transfer data between processes. It uses the [[Entity DSL]].

==[[Chart DSL]]==
The [[Chart DSL]] provides Vaadin dCharts.

==[[Cube DSL]]==
The [[Cube DSL]] provides MDX access to Mondrian OLAP Cubes.

==[[Datamart DSL]]==
A datamart is a condensed and more focused version of a data warehouse that reflects the regulations and process specifications of each business unit within an organization. Each datamart is dedicated to a specific business function or region.

==[[Dialog DSL]]==
The [[Dialog DSL]] generates the [https://vaadin.com/home Vaadin] UI

==[[Report DSL]]==
The [[Report DSL]] generates the [https://vaadin.com/home Vaadin] ui and [http://developer.actuate.com/about/ BIRT] report.

==[[Table DSL ]]==
The [[Table DSL]] generates the [https://vaadin.com/home Vaadin] table UI.

==[[Topology DSL ]]==
The [[Topology DSL]] generates [https://d3js.org/ D3.js], a JavaScript library for manipulating documents based on data, to generate the visualization of topology charts. Data used is [https://github.com/topojson topojson], an extension of [http://geojson.org/ GeoJSON] that encodes topology and the corresponding UI components.

==[[Entitymock DSL]]==
The [[Entitymock DSL]] generates mock data for entity models automatically upon initialization.

==[[Statemachine DSL]]==
The [[Statemachine DSL]] adds behavior to user interfaces. Instances of this DSL interconnect UI instances, FunctionLibrary instances, persistence layers and peripheral devices, and therefore act as controllers in a multiple Model-View-Controller environment. There is no limitation of how many statemachine instances control a single business application.

==[[Authorization DSL]]==

==[[Organization DSL]]==

==[[Topology DSL]]==

==[[Perspective DSL]]==

==[[How to add pictures]]==

=OS.bee specific DSL instances=
The OS.bee Software Factory provides a few specific DSL instances for different requirements. These are described in detail on the following pages.

==Datatypes==
Several custom datatypes are described in detail in this chapter.
===[[BlobMapping]]===
This datatype allows the use of big data as a blob.

=Other OS.bee specific solutions=
The OS.bee Software Factory provides also other solutions which will be described in detail on the following pages.

==[[Themes]]==

=OS.bee third party software solutions=
OS.bee also uses products of other software vendors (third party) that found on open source products.

==[[Peripheral Devices]]==