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

Revision as of 13:09, 4 May 2017

General information

Copyright Notice

All rights are reserved by Compex Systemhaus GmbH. In particular, duplications, translations, microfilming, saving and processing in electronic systems are protected by copyright. Use of this manual is only authorized with the permission of Compex Systemhaus GmbH. Infringements of the law shall be punished in accordance with civil and penal laws. We have taken utmost care in putting together texts and images. Nevertheless, the possibility of errors cannot be completely ruled out. The Figures and information in this manual are only given as approximations unless expressly indicated as binding. Amendments to the manual due to amendments to the standard software remain reserved. Please note that the latest amendments to the manual can be accessed through our helpdesk at any time. The contractually agreed regulations of the licensing and maintenance of the standard software shall apply with regard to liability for any errors in the documentation. Guarantees, particularly guarantees of quality or durability can only be assumed for the manual insofar as its quality or durability are expressly stipulated as guaranteed. If you would like to make a suggestion, the Compex Team would be very pleased to hear from you.

License information

The OS.bee Software Factory is distributed under a commercial license.

The product itself is based on the OSBP Software Factory which is an Eclipse project. In addition, the software depends on several other open source projects, and the entire list of licenses used can be found here.

Installation of the Software Factory

Before you start

Java Version

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

On Windows, this is Java JDK 8 64bit 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 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 -data /path/to/your/workspace 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 additions / changes to the eclipse.ini file found in the C:\eclipse folder:

-Dosgi.requiredJavaVersion=1.8
-Xmx4096m
-Dorg.eclipse.ecf.provider.filetransfer.retrieve.closeTimeout=3000
-Dorg.eclipse.ecf.provider.filetransfer.retrieve.readTimeout=3000

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

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

-startup
plugins/org.eclipse.equinox.launcher_1.3.201.v20161025-1711.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.1.401.v20161122-1740
-product
org.eclipse.epp.package.java.product
--launcher.defaultAction
openFile
-showsplash
org.eclipse.platform
--launcher.defaultAction
openFile
--launcher.appendVmargs
-vmargs
-Dosgi.requiredJavaVersion=1.8
-XX:+UseG1GC
-XX:+UseStringDeduplication
-Dorg.eclipse.ecf.provider.filetransfer.retrieve.closeTimeout=3000
-Dorg.eclipse.ecf.provider.filetransfer.retrieve.readTimeout=3000
-Dosgi.requiredJavaVersion=1.8
-Xms128m
-Xmx4096m

OS.bee P2 Repository

At the moment, the installation is only possible if you have access to the internal network. Use this --> 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.
Go to the menu bar and select Help -> Install New Software....
Get the link to the repository from the download page, as described above, and paste it into the field labeled Work with:. Then press Enter to make Eclipse load the content of the repository.
Open the "OS.bee Software Factory" group, select the "OS.bee Software Factory" and click on Next.
If during installation you encounter this just hit Next.
In the installation dialog, confirm the software to be installed by clicking on Next.
Accept the terms of the license aggreement after reading them carefully, and then confirm the dialog by clicking on Finish.
The installation will now start. This may take a while, depending on your internet connection speed.
After the software has been downloaded, confirm the "Security Warning" dialog by clicking on OK.
You will then be prompted to restart Eclipse. Please do so.

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.
Select "Default: ..." and click on Next.
Click on Add... to add content, select "Software Site" and click on Next.
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.
Change to register Content
- Enter x.a in the filter and deactivate the following bundles in the resulting target definition:
  
  javax.annotation version 1.2 javax.annotation.source version 1.2
- Enter guava in the filter and deactivate the following bundle in the resulting target definition:
  
  com.google.guava version 21.0
- Enter antlr in the filter and deactivate the following bundle in the resulting target definition:
  
  org.antlr.runtime version 4.3
  
  and click on finish.
Do not forget to activate your newly created target definition!
Restart Eclipse. You can use Menu -> File -> Restart to do so.

Set preferences in Eclipse

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"
Go to Window / Preferences in your Eclipse IDE, filter for "java" and go to Installed JREs and click on Search...

JDK Settings

Locate your JDK (On Windows it's usually under C:\Program FIles\Java\...) and hit OK
Select the newly added JDK and hit Apply, then OK

Maven Settings

Maven requires some settings in a file called settings.xml. 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):

 <?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">
	<!-- TODO: adapt the local path to your personal favourite -->
	<localRepository>c:/maven/.m2/repository</localRepository>

	<mirrors>
		<!-- mirror | Specifies a repository mirror site to use instead of a given 
			repository. The repository that | this mirror serves has an ID that matches 
			the mirrorOf element of this mirror. IDs are used | for inheritance and direct 
			lookup purposes, and must be unique across the set of mirrors. | <mirror> 
			<id>mirrorId</id> <mirrorOf>repositoryId</mirrorOf> <name>Human Readable 
			Name for this Mirror.</name> <url>http://my.repository.com/repo/path</url> 
			</mirror> -->

		<!-- not working mirrors p2: Gemini DBaccess maven: central.maven.org, -->
		<mirror>
			<id>Apache Mirror</id>
			<mirrorOf>apache-nexus-snapshots</mirrorOf>
			<url>http://www-eu.apache.org/dist/</url>
		</mirror>

	</mirrors>

	<!-- profiles | This is a list of profiles which can be activated in a variety 
		of ways, and which can modify | the build process. Profiles provided in the 
		settings.xml are intended to provide local machine- | specific paths and 
		repository locations which allow the build to work in the local environment. 
		| | For example, if you have an integration testing plugin - like cactus 
		- that needs to know where | your Tomcat instance is installed, you can provide 
		a variable here such that the variable is | dereferenced during the build 
		process to configure the cactus plugin. | | As noted above, profiles can 
		be activated in a variety of ways. One way - the activeProfiles | section 
		of this document (settings.xml) - will be discussed later. Another way essentially 
		| relies on the detection of a system property, either matching a particular 
		value for the property, | or merely testing its existence. Profiles can also 
		be activated by JDK version prefix, where a | value of '1.4' might activate 
		a profile when the build is executed on a JDK version of '1.4.2_07'. | Finally, 
		the list of active profiles can be specified directly from the command line. 
		| | NOTE: For profiles defined in the settings.xml, you are restricted to 
		specifying only artifact | repositories, plugin repositories, and free-form 
		properties to be used as configuration | variables for plugins in the POM. 
		| | -->
	<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>
				<!-- where to deploy the release artifacts -->
				<distribution.repository.release.url>${distribution.server.baseurl}:8086/nexus/content/repositories/developer-releases/</distribution.repository.release.url>
				<!-- where to deploy the snapshot artifacts -->
				<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>
					<!-- use the URL you installed the softwarefactory from -->
					<url>http://download.osbee.org/downloads/p2/osbee/neon/xxxxx
					</url>
					<layout>p2</layout>
				</repository>
			</repositories>
		</profile>
	</profiles>
	<!-- activeProfiles | List of profiles that are active for all builds. | 
		<activeProfiles> <activeProfile>alwaysActiveProfile</activeProfile> <activeProfile>anotherAlwaysActiveProfile</activeProfile> 
		</activeProfiles> -->
 </settings>

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

@@ Line 111: / Line 111: @@
 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):
+# 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">
-<syntaxhighlight lang="xml">
+ <?xml version="1.0" encoding="UTF-8"?>
-<?xml version="1.0" encoding="UTF-8"?>
-<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ <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">
@@ Line 266: / Line 265: @@
 		<activeProfiles> <activeProfile>alwaysActiveProfile</activeProfile> <activeProfile>anotherAlwaysActiveProfile</activeProfile>
 		</activeProfiles> -->
-</settings>
+ </settings></syntaxhighlight>
-</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]]

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

Revision as of 13:09, 4 May 2017

Contents

General information

Copyright Notice

License information

Installation of the Software Factory

Before you start

Java Version

Eclipse Version

OS.bee P2 Repository

Installation of the OS.bee Software Factory

Set the Target Platform for the OS.bee Software Factory

Set preferences in Eclipse

DS Annotations

JDK Settings

Maven Settings

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

Navigation

Tools