Skip to main content
Jump to: navigation, search

Difference between revisions of "Eclipse Installer"

(Getting in Touch)
 
(102 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{tip|New Version| Oomph started in October 2013 as part of the CDO Releng tools. Now that the [https://projects.eclipse.org/proposals/oomph Oomph proposal] has been accepted it is an independent project under Tools. <br>
+
[[File:Oomph_Project_Logo.png|link=Oomph]] <span style="font-size:90%;">[[Oomph|Powered by Oomph]]</span>
  
[[Image:NewInstaller.png]]
+
The Eclipse Installer automates the installation and update of Eclipse development environments:
  
The new installers are now available:
+
* [http://www.eclipse.org/downloads/download.php?file=/oomph/products/eclipse-inst-win64.exe Windows 64 Bit] (self-extracting exe)
* Download for [http://download.eclipse.org/oomph/products/org.eclipse.oomph.setup.installer.product-win32.win32.x86_64.zip Windows 64 bit]
+
* Download for [http://download.eclipse.org/oomph/products/org.eclipse.oomph.setup.installer.product-win32.win32.x86.zip Windows 32 bit]
+
* Download for [http://download.eclipse.org/oomph/products/org.eclipse.oomph.setup.installer.product-macosx.cocoa.x86_64.zip Mac OS 64 bit].
+
* Download for [http://download.eclipse.org/oomph/products/org.eclipse.oomph.setup.installer.product-linux.gtk.x86_64.zip Linux 64 bit].
+
  
<p>You can also install Oomph into an existing IDE via the [http://download.eclipse.org/oomph/updates update site].</p>
+
* [http://www.eclipse.org/downloads/download.php?file=/oomph/products/eclipse-inst-mac64.dmg Mac OS 64 Bit] (dmg) / [http://www.eclipse.org/downloads/download.php?file=/oomph/products/eclipse-inst-mac64.tar.gz Mac OS 64 Bit] (tar.gz)
<p>The remainder of this wiki page will soon be adjusted to reflect the new version. Meanwhile this [http://www.eclipse.org/community/eclipse_newsletter/2014/may/article3.php article] tells you more about the new Oomph.</p>}}
+
  
== What is Oomph? ==
+
* [http://www.eclipse.org/downloads/download.php?file=/oomph/products/eclipse-inst-linux64.tar.gz Linux 64 Bit] (tar.gz)
  
Eclipse Oomph is an installer and updater for Eclipse development environments. See what [http://www.thefreedictionary.com/oomph The Free Dictionary] says.
 
  
== Installation ==
+
To download the latest nightly build of the installer, pick one of
 +
[http://www.eclipse.org/downloads/download.php?file=/oomph/products/latest/eclipse-inst-win64.exe Windows 64 Bit],
 +
[http://www.eclipse.org/downloads/download.php?file=/oomph/products/latest/eclipse-inst-mac64.dmg Mac OS 64 Bit (dmg)],
 +
[http://www.eclipse.org/downloads/download.php?file=/oomph/products/latest/eclipse-inst-mac64.tar.gz Mac OS 64 Bit (tar.gz)],
 +
[http://www.eclipse.org/downloads/download.php?file=/oomph/products/latest/eclipse-inst-linux64.tar.gz Linux 64 Bit].
  
Just download the installer for your operating system and unzip it to your local disk:
+
You can also install the Oomph runtime into an existing IDE from the latest [http://download.eclipse.org/oomph/updates/latest update site] or [http://www.eclipse.org/downloads/download.php?file=/oomph/updates/latest/org.eclipse.oomph.site.zip site archive]. See [[#Update Sites|update sites]] for more...
  
* [https://hudson.eclipse.org/cdo/job/emf-cdo-integration/lastSuccessfulBuild/artifact/zips/Setup-Windows.zip Setup-Windows.zip]
+
Our [http://download.eclipse.org/oomph/help help center] is still work in progress but you may already find answers to your questions there.
* [https://hudson.eclipse.org/cdo/job/emf-cdo-integration/lastSuccessfulBuild/artifact/zips/Setup-Windows-32bit.zip Setup-Windows-32bit.zip]
+
* [https://hudson.eclipse.org/cdo/job/emf-cdo-integration/lastSuccessfulBuild/artifact/zips/Setup-Mac.zip Setup-Mac.zip]
+
* [https://hudson.eclipse.org/cdo/job/emf-cdo-integration/lastSuccessfulBuild/artifact/zips/Setup-Linux.zip Setup-Linux.zip]
+
  
Then start the included executable:
+
The installer is provided by the [http://www.eclipse.org/oomph Oomph] project.
  
[[Image:InstallerDialogScreenshot.png]]
 
  
The installer comes with a [http://git.eclipse.org/c/cdo/cdo.git/plain/plugins/org.eclipse.emf.cdo.releng.setup/help/installer/index.html help page].
+
[[Image:OomphSimpleInstaller2.png]]
  
 
+
See the [[Eclipse_Oomph_Authoring|Authoring Guide]] for details about how to customize the installer to create installations and provision workspaces for your specialized needs.
== Features ==
+
 
+
Non-exhaustive list of features:
+
 
+
* Provisioning correct set of plugins in the Eclipse IDE.
+
* Binding Git repos (incl. personal Gerrit push URL).
+
* Checking out projects.
+
* Setting workspace preferences.
+
* Configuring [[Setup-Eclipse/Dynamic_working_sets|dynamic working sets]].
+
* Keeping project preferences files in sync.
+
 
+
The configuration is model driven, with the possibility to customize a lot for each project, each branch, each user…
+
 
+
== Authoring Setup Models ==
+
 
+
Please read [[Eclipse Oomph Authoring]].
+
 
+
 
+
== Getting in Touch ==
+
 
+
First browse the [[#Frequently Asked Questions|FAQ]] section beow.
+
 
+
As a '''user''' you should post your questions and comments to the public forum:
+
 
+
* Web: [http://www.eclipse.org/forums/eclipse.oomph http://www.eclipse.org/forums/eclipse.oomph]
+
* Newsgroup: [news://news.eclipse.org:119/eclipse.oomph news://news.eclipse.org:119/eclipse.oomph]
+
 
+
You can also monitor the '''developer''' mailing list or discuss development topics:
+
 
+
* Archive: [https://dev.eclipse.org/mhonarc/lists/oomph-dev https://dev.eclipse.org/mhonarc/lists/oomph-dev]
+
* Mail: [mailto:oomph-dev@eclipse.org mailto:oomph-dev@eclipse.org]
+
* Newsgroup: [news://news.gmane.org:119/gmane.comp.ide.eclipse.oomph.devel news://news.gmane.org:119/gmane.comp.ide.eclipse.oomph.devel]
+
 
+
If you encounter '''trouble''' or miss a '''feature''' please:
+
 
+
* Search for [https://bugs.eclipse.org/bugs/buglist.cgi?classification=Tools&list_id=8268012&product=Oomph&query_format=advanced existing bugzillas] to avoid duplication.
+
* If nothing else helps kindly submit a new [https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Oomph&component=Setup&version=1.0.0 bug report] or [https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Oomph&component=Setup&version=1.0.0&bug_severity=enhancement feature request].
+
 
+
== See Also ==
+
 
+
* [http://www.winklerweb.net/index.php/blog/12-eclipse/20-creating-custom-installations-with-oomph Creating custom installations with Oomph] a blog post by Stefan Winkler.
+
* [http://ed-merks.blogspot.fr/2014/02/shoes-for-shoemaker.html Shoes for the Shoemaker] a blog post by Ed Merks about the setup tool.
+
* [http://dev.eclipse.org/mhonarc/lists/emf-dev/msg01679.html Emf-dev - CDO Releng tools - setup tool?]
+
* The [https://projects.eclipse.org/proposals/oomph Oomph project proposal].
+
 
+
== Frequently Asked Questions ==
+
 
+
=== How can I change values I've entered in the prompt dialog (e.g., my "git.user.id") once that dialog is gone? ===
+
In your installed IDE there should be button with a blue person in the main toolbar. Please click it to open your setup preferences. All prompted values are stored as VariableTasks in there and you're able to change them. (see [https://bugs.eclipse.org/bugs/show_bug.cgi?id=428268 Bug 428268])
+
 
+
=== How can I use a SSH private key with a custom file name (different from "id_dsa,id_rsa")? ===
+
In your setup preferences (see above) you have to add an "Eclipse Preferences" task to set the custom file name. The key of this node should be "/instance/org.eclipse.jsch.core/PRIVATEKEY", its value should be the name (not the path) of your private key file (e.g. "eclipse.ppk").
+
 
+
=== How can I use a custom SSH configuration directory? ===
+
In your setup preferences (see above) you have to add an "Eclipse Preferences" task to set the custom file name. The key of this node should be "/bundle_defaults/org.eclipse.jsch.core/SSH2HOME", its value should be the fully qualified path to your SSH configuration directory.
+
 
+
=== How can I add my own setup files? ===
+
In order to get your own setup file included, simply copy the respective *.setup file next to the Setup executable. In the case of OS X one has to manually copy this file into "Setup.app/Contents/Mac OS".
+
 
+
=== Oomph seems to update my IDE. Should I still use standard "Check For Updates..."? ===
+
You can. But consider these differences between Oomph and standard p2:
+
 
+
# p2 does not record a '''version range''' for the installed units so it will update to the hihgest available version, which might not be what you want. The "Diagram Editor for Ecore" is an example where the 2.x version is not able to load diagrams created with the 1.x version. Oomph in contrast uses a p2 director that is modified to understand and respect the version ranges as specified in the setup models.
+
# p2 uses the set of currently '''enabled p2 repositories''' for the update, which is often not immediately obvious and can change by just trying out new URLs in the "Install New Software" dialog. Oomph in contrast uses exactly the set of repositories that's specified in the setup models.
+
# p2 will always ask you to '''accept licenses''', whether you've already accepted them before or not. Oomph in contrast can remember the accepted licenses and won't bother you again. As this happens based on license UUIDs this approach is even safer because it prevents you from accidentally accept licenses with content that's just very similar but different (unintentionally or on purpose) from ones you've already accepted before.
+

Latest revision as of 09:00, 7 November 2018

Oomph Project Logo.png Powered by Oomph

The Eclipse Installer automates the installation and update of Eclipse development environments:


To download the latest nightly build of the installer, pick one of Windows 64 Bit, Mac OS 64 Bit (dmg), Mac OS 64 Bit (tar.gz), Linux 64 Bit.

You can also install the Oomph runtime into an existing IDE from the latest update site or site archive. See update sites for more...

Our help center is still work in progress but you may already find answers to your questions there.

The installer is provided by the Oomph project.


OomphSimpleInstaller2.png

See the Authoring Guide for details about how to customize the installer to create installations and provision workspaces for your specialized needs.

Back to the top