Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 255578

Summary: Install zip file not suitable for installation
Product: [Tools] GEF Reporter: Graham <Graham.Crowe>
Component: Website / WikiAssignee: gef-inbox <gef-inbox>
Status: RESOLVED WORKSFORME QA Contact:
Severity: normal    
Priority: P3 CC: ahunter.eclipse, irbull
Version: 3.4   
Target Milestone: ---   
Hardware: PC   
OS: Windows XP   
Whiteboard:

Description Graham CLA 2008-11-17 19:08:30 EST
Build ID: 3.4.1 M20080911-1700

Steps To Reproduce:
1. Start with a fresh install of Eclipse 3.4.1 Classic
2. Follow the instructions for GEF installation at http://wiki.eclipse.org/index.php/GEF_Developer_FAQ#Download_and_Install
Use the "Download the bits manually" section. The file I downloaded was called "GEF-ALL-3.4.1.zip"
3. Observe that this fails (Uncompressing the zip file into the Eclipse directory and restarting eclipse does not result in GEF being usable, it doesn't even appear on the list of installed plugins)


More information:
Changes in the way plugins are managed since Eclipse 3.4 seem to have broken a few plugin installers.

Of the many plugins I use (apart from GEF), the only ones which haven't broken are ones where you point the plugin manager to the downloaded zip file (the zip file is basically an update site which includes site.xml). If the GEF download could be provided in this format instead, then it would solve this issue.
Comment 1 Ian Bull CLA 2008-11-18 12:34:27 EST
Graham,

Thanks for pointing this out.  The bug here is our documentation is wrong.  Eclipse 3.4 released a new provisioning story, that is, a new way to get and install bits (plug-ins, bundles, features, what-have-you).  See [1] for more information on this.

If you want to use the zips, try unzipping them in your dropins folder (this folder should be in your eclipse directory.  However, it is better that you use the update manager, as p2 (the new provisioning platform) can more easily update / manage your configuration, dependencies, etc...

Can you report back here if the dropins folder worked for you?

[1] http://wiki.eclipse.org/Equinox_p2_Getting_Started
Comment 2 Anthony Hunter CLA 2008-11-18 12:58:27 EST
Ian, you do not have to use the dropins folder.

Graham, You are saying you download GEF-ALL-3.4.1.zip and eclipse-SDK-3.4.1-win32.zip and unzip in the same folder and when you restart Eclipse, GEF does not work.

Note I do this each week to smoke test the GEF builds and I do not use the dropins folder.
Comment 3 Graham CLA 2009-01-13 20:13:35 EST
Ian, Thank you, the dropins directory works well.

Anthony, I have done quite a bit of reinstalling and testing to figure out exactly what was the issue with the "plugins" directory. It would appear as if copying the plugin into the "plugins" directory is enough to get Eclipse to see the plugin and use it, but when installing another plugin (from an update site provided as an "archive" file) which requires GEF then for some reason it refuses to install due to failed prerequisites. This problem does not occur when using the dropins folder.

This can be seen in the menu item "Help" -> "Software Updates" under the "Installed Software" tab. If you copy the GEF installation into the "dropins" directory, then the GEF packages appear in this window (and installation of packages which require GEF work OK) but if you copy the GEF installation into the "plugins" directory the the GEF packages do not appear in this window (and installation of packages requiring GEF as a pre-requisite do not work properly from update sites / archive files).

Note that this testing was done on a PC that does not have access to update directly via the internet.
Comment 4 Ian Bull CLA 2009-01-13 22:06:16 EST
Good to hear it's working.

I have talked to some of the p2 team (the team that is responsible for install / provisioning of bundles) and while you *can* put things in the plug-ins folder, this is not encouraged.  In eclipes 3.4 the entire install story was changed, and putting things in the plug-ins folder was left (for backwards compatibility), but this is not really supported and things are very brittle.

Even drop-in folders are not encouraged, but they work.  The best is to use the install / update manager.  You may be able to even point at a GEF zip from here and have it properly install. 
Comment 5 Graham CLA 2009-01-13 22:42:20 EST
I have tried to point the update manager to the GEF zip file, but it is not in the correct format to be used as an update site archive. The only way (that I am aware of) to use the GEF install zip file as it currently exists is to unzip it into the dropins directory.

Since it is now not encouraged to install using this method, is there any chance that the GEF install zip files could be provided in update site archive format? For good examples of this, see the files available for download for the CDT or Mylyn plugins, as they are in this format and I find them quite convenient and easy to use.

I am not certain as to exactly what is involved in packaging them up in this way, but I suspect that it may be as simple as zipping up some of the files from the update manager's server into a single zip archive.
Comment 6 Ian Bull CLA 2009-01-14 01:26:57 EST
(In reply to comment #5)
> I have tried to point the update manager to the GEF zip file, but it is not in
> the correct format to be used as an update site archive. The only way (that I
> am aware of) to use the GEF install zip file as it currently exists is to unzip
> it into the dropins directory.
> 
Thanks for trying. I know this is something they want to do, I guess it is not there yet.

> Since it is now not encouraged to install using this method, is there any
> chance that the GEF install zip files could be provided in update site archive
> format? For good examples of this, see the files available for download for the
> CDT or Mylyn plugins, as they are in this format and I find them quite
> convenient and easy to use.

Sorry, I misspoke.  What I meant was, dropins are not p2's preferred way to work.  But they are supported. (i.e. the p2 team would rather everyone use the install manager, but for many reasons this will never happen).

Does the update site work for you?
http://www.eclipse.org/gef/updates/

> 
> I am not certain as to exactly what is involved in packaging them up in this
> way, but I suspect that it may be as simple as zipping up some of the files
> from the update manager's server into a single zip archive.
> 
For us, it's a resource thing.  We have one guy (yeah Nick!) who does the builds for about 15 different projects, and that's no longer his day job.  I'm not sure how to customize his build infrastructure to support this.  



Comment 7 Anthony Hunter CLA 2009-01-14 12:27:38 EST
(In reply to comment #6)
> > 
> > I am not certain as to exactly what is involved in packaging them up in this
> > way, but I suspect that it may be as simple as zipping up some of the files
> > from the update manager's server into a single zip archive.
> > 
> For us, it's a resource thing.  We have one guy (yeah Nick!) who does the
> builds for about 15 different projects, and that's no longer his day job.  I'm
> not sure how to customize his build infrastructure to support this.  
> 

The Galileo GEF 3.5 builds do just that.

There are no plans to do anything additional for 3.4.2, so I am going to resolve this Bugzilla as information provided / works for me/us/etc.
Comment 8 Graham CLA 2009-01-21 00:10:24 EST
Ian,
    Unfortunately that update site does not work for me as the PC I am installing it on does not have access to the internet. We install from manually downloaded files for the following reasons.
1) Due to past problems with libraries and documentation becoming unavailable over time there are contractual requirements on some of our projects to maintain a local archive of all development tools, libraries and documentation.
2) I mainly work on industrial process control networks, which are often isolated from the internet for security.


Anthony,
    I am happy to wait for the 3.5 release now that I have an interim solution working.


Thanks