root/main/trunk/gli/FLI_README.txt @ 31701

Revision 16514, 3.2 KB (checked in by ak19, 11 years ago)

Updated further to take recent modifications to FLI code into account.

Line 
1FLI, the Fedora Librarian Interface:
2____________________________________
3
4A Purpose of FLI:
5FLI is built on top of GLI. Just as with GLI, it allows you to drag-and-drop documents into a collection which it will then build. The building process of FLI is different in that it will export the documents into a Fedora repository.
6
7
8B Some limitations and workarounds
9- You need the Greenstone server to be running on the same machine as where your Fedora machine is running. This may or may not remain a requirement in the future.
10- FLI will put documents into the Fedora repository (a process called "ingesting into Fedora"). If you happen to encounter some connection failure problems please try the following and also inform us of the context of your problem. To overcome such a problem, what you need to do is:
11 * Stop the fedora server
12 * Go to FEDORA_HOME/tomcat/conf/Catalina/localhost/
13(where FEDORA_HOME is your Fedora installation folder)
14 * Create a file containing this XML:
15<?xml version='1.0' encoding='utf-8'?>
16<Context docBase="/full/path/to/parent/folder/of/your/greenstone/collectdir" path="/gsdl"></Context>
17Where this full path would be your
18- GSDLHOME/web/sites/localsite for Greenstone 3, and
19- just plain GSDLHOME for Greenstone 2.
20Note that in both cases, it has to be the full path to the parent directory of the "collect" directory.
21 * restart the fedora server
22 * Now you can run FLI as described below.
23
24
25C Prerequisites for running FLI:
26- You need Greenstone 2 or 3
27- You need Fedora installed (which would have required you to set the environment variables FEDORA_HOME, CATALINA_HOME and JAVA_HOME). Then add a new environment variable called FEDORA_VERSION and set it to the value of your Fedora installation's version number.
28- You need the Greenstone server running on the same machine as where your Fedora server is installed.
29
30
31D Running FLI:
32- If you have more than one Greenstone installed (Greenstone 2 and Greenstone 3), then first run the setup file for the Greenstone installation you want to use, so that your Greenstone environment is set up.
33If you were on linux, you would have to source the setup scripts by going into the Greenstone installation directory and typing
34    source setup.bash
35if it is Greenstone 2.
36And
37    source gs3-setup.sh
38if it is Greenstone 3. 
39If you're on Windows you would run setup.bat in the Greenstone 2 folder or gs3-setup.bat in the Greenstone 3 folder.
40- If you're using a linux xterm, you'd go into Greenstone's gli folder and type:
41    ./fli.sh
42If you're on Windows, go into Greenstone's gli folder and double-click on fli.bat
43- Once FLI starts up, it will ask you the Fedora server details and your Fedora username and password to access the Fedora repository.
44- Drag and drop documents into a collection as before, go to the Build tab and press the Build button. Once the building is finished, pressing the preview button will open the browser onto the Fedora search page.
45- If you have other digital objects in your Fedora repository besides the content generated by Greenstone, you will have to type "greenstone:*" (or just "greenstone*") in the search box--with the quotes.
46If your Fedora repository only contains documents built in FLI, then pressing just the search button should be fine.
Note: See TracBrowser for help on using the browser.