[greenstone-users] Re: [Greenstone3] about using eclipse with greenstone3

From Anupama of Greenstone Team
DateFri Apr 18 17:38:54 2008
Subject [greenstone-users] Re: [Greenstone3] about using eclipse with greenstone3
In-Reply-To (48070A34-2090902-cis-strath-ac-uk)
Hello Suthanya,

Thank you for the document.

1. I have made a walkthrough with screenshots at
I hope this may help you in the Subclipse and Greenstone3 installation
process. First however, rename the folder you have called "$SUBCLIPSE"
to plain "subclipse". (Perhaps $ signs in file and folder names may
cause problems.)

2. I have updated the page
to take into account the information you've given me (see below).

The following is the stuff I wrote earlier today and addresses
particular questions in the document you sent me.


a. In your document, you wrote:
> $GSDLHOME/lib/jni/ ----> it does n?t have file
You are right. It would not have the file because these jar files are
generated. I made the terrible mistake of trying to create the Eclipse
project (for that part of the wiki walkthrough) from my local Greenstone
3 folder which I had *already* compiled. That is why that part worked
for me and did not for you.
I have updated the wiki page with the necessary changes.

b. You wrote:
> After that I will try to compile the codes
From the screen captures, it looks like you were trying to run it
rather than compile it. Eclipse compiles java files by default without
us having to press any buttons. And, in my situation, it shows
compilation errors by underlining unresolved import statements with with
red squigly lines.
However, in the case of the Greenstone3 code we are importing, we will
not leave the compilation up to Eclipse. There is an Ant build.xml file
that we will be using instead, which the Greenstone developers had
prepared for compiling the code of the large Greenstone project.
Having spoken to another Greenstone3 developer just now, I found that he
only uses Eclipse as an editor for Greenstone code and that he does the
compiling through the Linux command prompt/x-term (using "ant prepare
install"). The same is possible within Eclipse by using its Run >
External Tools > External Tools to create an Ant Build Configuration
using the existing build file. But I will explain all that shortly after
going through the questions in the document you sent me.

c. Your document has a screen capture that shows that when you tried to
install subclipse,
- you set the Local Site URL to:
And wrote that:
> And the I clicked on Finish, I can?t install subscripse successful.

There may be several issues here.
- In the wiki I did not clearly specify that $SUBCLIPSE is a
placeholder--a variable--which we are supposed to replace with the full
path to the $SUBCLIPSE folder. I have now corrected the wiki page to
explain it better.
- It may perhaps not be a good idea to name folders "$SUBCLIPSE". I do
not know what strange effect the $ sign may have. Will you rename the
folder to plain "subclipse"?

In this case, once you've renamed your folder to "subclipse", go back to
Eclipse and try to install Subclipse again. In the New Local Site dialog
you would type:
- in the Name field you can type any name, for example Subclipse 1.2.4.
- And in the important Local Site URL field, browse to
(in your case, the variable $SUBCLIPSE refers to
Alternatively, you can press the New Archived Site button instead of New
Local Site and give it the full path to your site-1.2.4.zip file.

There are two remarks that still need to be made, though:
a) I don't have any experience with installing it (successfuly) on
Windows yet. I can try it over the weekend on my windows computer at
home using Eclipse, and tell you how I go.

b) From the second-to-last screen capture in your document, it looks to
me like you are trying to use Subclipse after having already imported
Greenstone 3 code into a Project. I don't think that's necessary.
Subclipse is used to "checkout" (download) Greenstone code from the
Greenstone online repository into your Eclipse project. That is, you
will be starting a completely empty Greenstone project and then
downloading Greenstone code in the right folder structure when you use

The first two screen captures in your document shows how you downloaded
Greenstone3 for windows. If you would rather not use Subclipse but
compile Greenstone from this other download, then that alpha
distribution for windows which you have marked with a square in your
first screenshot looks like it is an executable (.exe). Does the
installer give you access to the source code like Greenstone2's
installer does? If it does not, then you might want to try the link to
"Source" at http://sourceforge.net/project/showfiles.php?group_id=151210
There will be a build file and a Greenstone3.tar.gz file there. Though I
have not tried it, I believe you will need both. If you are on Windows,
and don't already have an unzipping facility for tar.gz, try downloading
the free "7-zip" software which you can find if you search Google for it.

Don't forget to have a look at the document at
And best of luck with installing,

Suthanya Doung-In wrote:
> Dear Anupama,
> Thank you very much for your help:-). I working on Windows XP. After
> i recieved your email, i try to import greenstone(version 3.03) source
> code into Eclipse and try to install subclipse again by following
> http://wiki.greenstone.org/wiki/index.php/Using_Eclipse_with_Greenstone_3#Creating.2C_compiling_and_running_an_Eclipse_project_of_Greenstone_3_source_code_from_SVN_using_Subclipse
> However, I still have problem, and i sent the document that i capture
> procedure of importing greenstone into Eclipse and error screen. Please
> kindly find an attached file. Thank you so much in advance.
> Best Wishes,
> Suthanya
> ------
> ak19@cs.waikato.ac.nz wrote:
>> Hi Suthanya,
>> When I read your question, I went over that wiki page again to follow it
>> from scratch. That meant I had to uninstall the Subclipse plugin which
>> enables SVN for eclipse. The uninstallation caused something to go wrong
>> with my personal Eclipse configuration files so that I for the last two
>> days I have been unable to reinstall the plugin except in /usr/share
>> where
>> I don't have permissions. Fingers crossed, it looks like this problem may
>> be sorted out now, after which I will try out the steps on that Wiki page
>> again to uncover whether I left out describing some crucial steps.
>> May I know what operating system you are working on? I have so far only
>> successfully got GS3 working on Linux and the wiki page was written as a
>> walkthrough for Linux.
>> What part of that wiki page did you get working, where did the process
>> start failing for you?
>> - Did you get subclipse installed successfully ?
>> - Were you able to checkout greenstone3 code from within Eclipse (using
>> subclipse)?
>> - Are you having compilation errors after checking out the code? That is,
>> is Eclipse marking any java files and packages with a cross next to it to
>> indicate missing imports?
>> - Or did all this work out for you, but you are having trouble
>> successfully compiling and building with Ant?
>>> Could you suggest me about how to run and compile the source codes
>>> please?
>>> or do you have any helpful documents or web pages to recommend me? Thank
>>> you versy much in advance.
>> There is the option of trying to install Greenstone 3 without Eclipse.
>> Using the X-term.
>> See
>> -
>> http://wiki.greenstone.org/wiki/index.php/Installing_Greenstone3#How_do_I_compile_Greenstone3_from_a_source_or_SVN_distribution.3F
>> for the important steps
>> -
>> http://wiki.greenstone.org/wiki/index.php/Walkthrough:_installing_Greenstone_3_from_SVN_source
>> for a detailed walkthrough which now also includes a longer
>> Troubleshooting section.
>> If you could try that in the meantime, I will from my end try to get back
>> to you on the matter of Eclipse/Subclipse (if it's successfull).
>> Regards,
>> Anupama
>>> Hi all,
>>> I would like to develop digital collection by greenstone software
>>> version 3 and try to develop and customize user interface as the
>>> developer. I import greenstone 3 source files into eclipse program by
>>> following the detail on
>>> http://wiki.greenstone.org/wiki/index.php/Using_Eclipse_with_Greenstone_3#Creating.2C_compiling_and_running_an_Eclipse_project_of_Greenstone_3_source_code_from_SVN_using_Subclipse
>>> However, I got a problem about this. The error displayed "lauching admin
>>> (Time of error:3 april 2008......") Reason: check the detail. Could you
>>> suggest me about how to run and compile the source codes please? or do
>>> you have any helpful documents or web pages to recommend me? Thank you
>>> versy much in advance.
>>> Regards
>>> Suthanya
>>> _______________________________________________
>>> Greenstone3 mailing list
>>> Greenstone3@list.scms.waikato.ac.nz
>>> https://list.scms.waikato.ac.nz/mailman/listinfo/greenstone3