======Running FLI, the Fedora Librarian Interface======
===== The purpose of FLI=====


FLI 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.

===== Limitations=====

  * You need the Greenstone server to be running on the same machine as where your Fedora machine is running. This //may// not be a requirement in the future, but it is at present.


===== Prerequisites for running FLI=====

  * You need Greenstone 2 or 3
  * You need Fedora installed (which would have required you to set the environment variables FEDORA_HOME, CATALINA_HOME and JAVA_HOME, which are also needed by FLI). See [[en:extra:fedora]].


And:

  * You need to add a new environment variable called FEDORA_VERSION. If the version you have installed is Fedora 2.*, then you set this to 2, if you have Fedora 3.* installed, then you'd set this environment variable to 3.


If you are running **client-fli** against remote Greenstone and Fedora server, and you haven't set the environment variables FEDORA_HOME and FEDORA_VERSION, then you can set these in the gsdlsite.cfg file.


If running client-fli against a remote GS2 server, then you need to set the JAVA_HOME environment variable, which can also be set in the same gsdlsite.cfg file. See gsdlsite.cfg for more details.
  * In Greenstone 3, gsdlsite.cfg is located inside Greenstone 3's web/WEB-INF/cgi folder. 
  * In Greenstone 2, gsdlsite.cfg is located inside Greenstone 2's cgi-bin folder.

  * You need the Greenstone server running on the same machine as where your Fedora server is installed.


===== Running FLI=====

  * 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.

 
If you were on linux, you would have to source the setup scripts by going into the Greenstone installation directory.


For Greenstone 2, you'd have typed:
<code>source setup.bash</code>
And for Greenstone 3:
<code>source gs3-setup.sh</code>
If you're on Windows you would run setup.bat in the Greenstone 2 folder or gs3-setup.bat in the Greenstone 3 folder.

  * If you're using a Linux xterm, you'd go into Greenstone's gli folder and type:
<code>./fli.sh</code>
If you're on Windows, go into Greenstone's gli folder and double-click on fli.bat

  * Once FLI starts up, it will ask you the Fedora server details and your Fedora username and password to access the Fedora repository.
  * 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. 

  * //If// you have other digital objects in your Fedora repository besides the content generated by Greenstone, you will have to type
<code>"greenstone:*"</code>
or just 
<code>"greenstone*"</code>
in the search box with the quotes.


If your Fedora repository only contains documents built in FLI, then pressing just the search button should be fine.