Eclipse Community Forums: Oomph » Documentation confusion

Home » Eclipse Projects » Oomph » Documentation confusion(Oomph customization issue)

Documentation confusion [message #1780043]

Tue, 16 January 2018 13:25

Eclipse User

I've been customizing Eclipse for year using various scripting, the B3 Aggregator. Creating custom repositories with hundreds of carefully tested inter-connected plug-ins. It is a pain.

I'm a bit late to the party of Oomph, but that is due to the fact my old system worked very well for what I needed. It doesn't anymore.

I am not a Java developer. I'm a packager who specializes in Open Source and herding cats. I am reading the Oomph documentation and trying out the suggestions but I am confused at what may be a very basic level.

Given I -
- Download the Eclipse Installer
- Launch the Eclipse Installer with -vmargs --Doomph.redirection.setups=http://git.eclipse.org/c/oomph/org.eclipse.oomph.git/plain/setups/->file://mynetwork/testlocation/setups

it does not appear to actually pick up my testlocation, or the other -Doomph redirection I provide.

I'm trying to fully internalize Eclipse so that it can use a Nexus/Artifactory storage location, and not access the outside world anywhere.

There are parts of the documentation that state "TBD" (since 2014?) and other that talk about customizing the eclipse.ini and eclipse_inst.ini file but these do not appear to be in the Eclipse_Installer Jar (when I unzip to peak under the covers).

Am I missing something obvious?

Re: Documentation confusion [message #1780044 is a reply to message #1780043]

Tue, 16 January 2018 13:57

Eclipse User

Part of this is there is no explanation of eclipse installer that is obvious for customization that https://wiki.eclipse.org/Eclipse_Oomph_Authoring#How_to_extract_the_constituent_parts_that_comprise_the_Windows_self-extracting_installer_executable is a needed step to get all the parts needed to really customize things properly. Personal option there.

Re: Documentation confusion [message #1780056 is a reply to message #1780044]

Tue, 16 January 2018 17:37

Eclipse User

Uncompressing the Oomph install (Eclipse installer) there is the eclipse.ini and what appears to be the full package of Oxygen.2 but this isn't what I want.

Is there an easy way to test if the Oomph installer is going to the local packages and/or the projects. It doesn't seem Oopmh provides logs to see where it is looking for files.

Re: Documentation confusion [message #1780063 is a reply to message #1780056]

Tue, 16 January 2018 22:02

Eclipse User

(sorry for the new messages, I prefer to document this way so I can better suggest documentation changes in the future).

It turns out my issue may be the Cache was not being wiped after launching with the --Doomph.redirection.setups=http://git.eclipse.org/c/oomph/org.eclipse.oomph.git/plain/setups/->file://mynetwork/testlocation/setups
Is there a way to ensure the cache is invalidated automatically?

Re: Documentation confusion [message #1780065 is a reply to message #1780063]

Tue, 16 January 2018 22:57

Eclipse User

Yes, the documentation could be improved. In a couple of your messages you have two "-" in front of your -D option so that doesn't seem right. Also the target URI of the redirection doesn't end with a / so it will not redirect the entire folder as well as everything under it. You shouldn't need to clear the cache. Generally the default http://www.eclipse.org/setups/setups.zip will be loaded and processed regardless so that its redirections are also available, but your redirection of the root folder location will cause a different index.setup to be loaded, which could still use any of the URIs in the default, if it chooses. This URI (org.eclipse.oomph.setup.internal.core.SetupContext.INDEX_SETUP_ARCHIVE_LOCATION_URI) too can be redirected. You can build a setup archive using the org.eclipse.oomph.setup.internal.core.SetupArchiver IApplicaton. The documentation vaguely alludes to this with a TBD comment. Are you still making progress or are you stuck?

Re: Documentation confusion [message #1780067 is a reply to message #1780065]

Tue, 16 January 2018 23:22

Eclipse User

Thanks Ed. As a Shoemaker I appreciate this. (sorry to poke fun at your wonderful 2014 blog entry that answered a LOT of underlying questions I had!)

I'm slowly moving forward with this. Read almost the full forum back to March 2016 now. You are a saint and deserve many bottles of wine.

If I do the following:

-vmargs -Doomph.redirection.setups=http://git.eclipse.org/c/oomph/org.eclipse.oomph.git/plain/setups->file://mynetwork/testlocation/setups

And launch (btw This is with the Windows 64bit Exe, thank you for fixing the not-handling -vmargs issue from 2016 :) ) the Oomph's Product Catelogs I still see the orignal Eclipse.org Catelog. Can this be removed?

I see booth my custom Catelog (which is currently Blank as I learn) and the Eclipse.org one even when launching a non-VMArg eclipse_installer.exe after doing the -VMarg option. So its reading it from the cache somewhere.

I am about to start going through the offical Catelog you have (great effort! You deserve more hype for that great resource to the Eclipse Developer world) and converting it to a local mirror internally. We can't have any external references (I have a script that reads the archive and content P2 data to remove those links already) and need to put in some custom plug-ins by default.

The documenation is great considering it is just two very busy people doing it. The EMF bones show through and I'm very happy with that work you have done in the past.

(Note the Example on https://wiki.eclipse.org/Eclipse_Oomph_Authoring#Hosting_your_own_index_.2F_catalogs does have the end slash on setup/)

[Updated on: Tue, 16 January 2018 23:26] by Moderator

Re: Documentation confusion [message #1780069 is a reply to message #1780067]

Wed, 17 January 2018 00:37

Eclipse User

Oomph has definitely been a huge investment of time, but it's definitely cool and unfortunately documenting things is not much fun so that ends up lacking in comparison to all the cool stuff that's possible. But mostly we hear from people only when things go wrong, because of course no good deed goes unpunished.

Unfortunately there is no way to pass arguments to the self-extracting Windows executable that are then also passed through to the underlying eclipse-inst.exe. It's probably not so hard to do, but that code is native and written in C (by Eike), and with our new machines, we've not been able to get it to compile; kind of scary...

I really think your argument should be like this:

-vmargs -Doomph.redirection.setups=http://git.eclipse.org/c/oomph/org.eclipse.oomph.git/plain/setups/->file://mynetwork/testlocation/setups/

I.e., with a trailing / on both URIs, because that is what specifies a so-called folder mapping for EMF's URI converter's URI map which is used under the covers. And this needs to be passed to the eclipse-inst.exe or added in the eclipse-inst.ini. In the Oomph development environment we specify this VM argument in the launch

-Doomph.redirection.setups=http://git.eclipse.org/c/oomph/org.eclipse.oomph.git/plain/setups/->${file_uri:${resource_loc:/setups}}/

In order to redirect the launcher installer product to use what's currently in the Oomph git clone rather than what's been checked-in and archived so this definitely is the way to go.

Previous Topic:	Exclude a preference ftom sync
Next Topic:	Custom Eclipse-Installer

Goto Forum:

-=] Back to Top [=-

Current Time: Sun Jul 13 22:55:43 EDT 2025

.:: Contact :: Home ::.

Breadcrumbs

Sign up to our Newsletter