[greenstone-devel] Re: [again] installation Fedora

From Anupama of Greenstone Team
DateTue Jun 24 12:41:42 2008
Subject [greenstone-devel] Re: [again] installation Fedora
In-Reply-To (485FF1C9-90105-cis-strath-ac-uk)
I looked at your Word document. There are several issues here, first
comes the list of explanations and the suggsteions of what to do:

a. About Environment variables:
These are variables that get resolved to their actual value.
For instance (Linux example)
export FEDORA_HOME=/full/path/to/my/home/folder
Now the system knows what FEDORA_HOME means, and you can refer to the
variable's *value* by using $FEDORA_HOME:
which will print that full path.

Similarly on Windows, you use the Control Panel dialog (as you did in
the screenshots) to set FEDORA_HOME to the folder where your fedora is
installed. For instance, let us assume it is C:fedora3 for you. In the
dialog you would type:
variable name: FEDORA_HOME
variable value: C:fedora3
(Put quotes around any paths containing spaces)
When you want to programmatically use the variable FEDORA_HOME
afterwards, you would put % signs around it. For example, typing:
in a DOS prompt will print the value of the variable: C:fedora3.

For the FEDORA_HOME variable, you should not have more than 1 value. In
the screenshot in your document, you have several paths listed for
FEDORA_HOME. Please correct it to just the path where you want fedora

b. You wrote "I have no idea about this but I choose to type
%FEDORA_HOME%serverbin" when it asked you during Quick installation of
Fedora what folder you want to put the scripts into.
It provides a default, therefore just pressing Enter would be alright,
since you have set the FEDORA_HOME environment variable already. But if
you were to specify it explicitly, you would (going with our example
above) have to type: C:fedora3serverbin
because it is going to take what you type *literally* and use that as
the folder for the fedora installation. Since you typed
"%FEDORA_HOME%serverbin", it has created a folder called %FEDORA_HOME%
and put stuff in there. This folder now no longer matches the
FEDORA_HOME variable you set. (As a general guideline, it is best not to
name a folder %something% on windows.)

c. You will need to fill in that Environment Variable dialog three
times. This will cause problems as you already noticed but I'll talk
about that later. Here are examples. In your case the folders may be

variable name: FEDORA_HOME
variable value: C:fedora3

variable name: CATALINA_HOME
variable value: C:fedora3 omcat

You will already have JAVA_HOME set, if not:
variable name: JAVA_HOME
variable value: C:jdk1.5.0_10

Finally, the variable PATH (or Path) already exists. Look in the
dialog's list. You will have to edit it in order to successfully install
Fedora 3. Be very careful, because any mistakes can potentially mess up
your Windows OS.

The explanation at
"PATH This must include the Java and Fedora bin directories. For
Windows, this will be %FEDORA_HOME%serverbin, %FEDORA_HOME%clientbin
and usually %JAVA_HOME%bin."

If you choose to edit variable name: PATH (or Path as it may appear on
your machine), then APPEND the following to the end of its existing value:
You would already have created a variable for JAVA_HOME when you
installed Java. Therefore I think JAVA_HOME would already be on your
Path, but if it is not, just append it the above PATH variable:

d. The reason why your Greenstone 3 didn't work when Fedora was running
is that they are both set to listen on the same port (8080) and you had
both servers running at the same time. Either stop one server every time
you wish to run the other, or change the port on which the Greenstone 3
server is listening by following the instructions given at:
Stop the Greenstone 3 and Fedora servers first before changing the port
for Greenstone 3.

e. To run Fedora on Windows, you will have to call the Windows script,
which has the .bat extension. (The .sh extension are for scripts that
run on Linux). This means, that in a DOS prompt, you would run:
c:> c:fedora3 omcatbinstartup.bat
to start the Fedora server, and
c:> c:fedora3 omcatbinshutdown.bat
to stop it.

There may be a problem with permanently fixing CATALINA_HOME as the
tomcat folder in Fedora, since Greenstone 3 also uses CATALINA_HOME but
for GS3 it is supposed to be set to a different tomcat folder from the
one that Fedora uses.

What you can try is to leave out setting CATALINA_HOME through the
Control Panel dialog. Instead you can set this in the DOS prompt, which
means CATALINA_HOME will be set only for that session (for that DOS
You can open two DOS prompts. One will be to run Fedora, the other for
running Greenstone 3. That way I *think* they might both have their own
localised environment settings for CATALINA_HOME and not conflict.

Try the following:
1. Stop the Fedora server if you had it running. Stop GS3 server too.
Basically, make sure no Tomcat for either is running and stop it if it is.
2. Uninstall Fedora 3 (I do not know how to correct the current
installation you have, so you may have to resort).
3. Set FEDORA_HOME, JAVA_HOME and adjust the PATH as explained earlier.

4. Reinstall Fedora 3 as before from the DOS prompt.
a. Type Quick.
b. Then just keep pressing Enter to accept the default suggestions (in
any case, make sure not to type %FEDORA_HOME%serverbin or similar
values for any paths, type full paths instead).
c. Choose a username and password.

5. Change the Greenstone 3 port as described in the link mentioned in d
above. For instance, you can set GS3's port number to 9090.

6. Continue using the same DOS prompt. This one will be used for running
a. Type the following, making sure to substitute your Fedora 3
installation location:
set CATALINA_HOME=c:fedora3 omcat
b. Startup Fedora by typing
c:fedora3 omcatbinstartup.bat
Make sure to substitute the correct path to your Fedora installation.
c. After some time (30 seconds or less), the Fedora server will have
started up properly. Go to http:\localhost:8080fedorasearch
and check that it works.
(d. You can stop it by typing
c:fedora3 omcatbinshutdown.bat
Once again, substitute the path to your Fedora installation.)

7. Open another DOS window. We'll use this for running Greenstone 3:
a. go to the Greenstone 3 installation directory
b. Run the GS3 server by typing
ant start
c. Check it is running. If you had changed the port to 9090, you'd go to
Also check

8. Run the GS3 democlient application. Remember to type the correct port
number values when trying to connect to either server.


Suthanya Doung-In wrote:
> Dear Anupama,
> I try to remove environment variable that are: CATALINA_HOME [ i
> think it may be conflict with TOMCAT] and FEDORA_HOME. After that, i try
> to run gs3-democlient web service again, Tomcat running!!!! but i can't
> run greenstone librarian interface;-(.
> Best Wishes,
> Suthanya