en:developer:install_fedora_gsearch
no way to compare when less than two revisions
Differences
This shows you the differences between two versions of the page.
— | en:developer:install_fedora_gsearch [2023/03/13 01:46] (current) – created - external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | |||
+ | |||
+ | ======Fedora Generic Search Installation ====== | ||
+ | |||
+ | |||
+ | Fedora Generic Search (Fedora GSearch) provides full-text indexing and searching for Fedora. This functionality is not offered by Fedora out-of-the-box, | ||
+ | |||
+ | |||
+ | In this document, | ||
+ | |||
+ | |||
+ | |||
+ | * $FEDORA_HOME refers to the full path to your Fedora installation directory. | ||
+ | |||
+ | * You need to have Fedora installed in order to install Fedora Generic Search. | ||
+ | |||
+ | |||
+ | For a walkthrough on installing Fedora (and for links to the official Fedora instructions for installation) see [[en: | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | This document describes **two ways** in which you can install Fedora Generic Search: | ||
+ | |||
+ | * By downloading Muradora' | ||
+ | * by doing the same steps manually. | ||
+ | |||
+ | See also the final section containing [[# | ||
+ | |||
+ | |||
+ | ===== Using the GSearchInstaller===== | ||
+ | You will need Java 1.5 or higher, which would also have been required to install Fedora itself. | ||
+ | |||
+ | * Download [[http:// | ||
+ | * Download the GSearchInstaller.jar from the same place where you got the GS3 Web Services Demo-Client (GSearchInstaller.jar is part of the GS3 Web Services Demo-Client distribution file). | ||
+ | * In a Linux x-term or a Windows DOS prompt, go to the location where your GSearchInstaller.jar is located, and type | ||
+ | < | ||
+ | This will launch the installer' | ||
+ | |||
+ | |||
+ | (It is recommended that Windows users don't just double-click on the jar file as the application' | ||
+ | * Type in your Fedora server host, port, username and password. Then choose a name for the Fedora GSearch index and repository. (By default, the GS3 Web Services Demo-Client application expects the index name to be // | ||
+ | |||
+ | |||
+ | **Note:** GSearchInstaller can also be run from the command-line, | ||
+ | < | ||
+ | * It will take a little while to run, and if nothing went wrong, it will have installed Fedora Generic Search and indexed the [8RunFedoraLibrarianInterface.html Greenstone documents that were ingested into Fedora using FLI]. | ||
+ | |||
+ | |||
+ | If you're running on Windows, GSearchInstaller will sadly open quite a number of DOS consoles and leave them open. You'll have to manually close each of them (for instance, by typing //exit// in them). | ||
+ | |||
+ | |||
+ | ===== Manual Installation===== | ||
+ | |||
+ | * [[http:// | ||
+ | * Next to the steps above, you will need to make some more changes in order to enable full-text indexing and searching of the Greenstone documents ingested into the Fedora repository. | ||
+ | * Open the file: | ||
+ | |||
+ | < | ||
+ | |||
+ | At present, Muradora' | ||
+ | |||
+ | < | ||
+ | ... | ||
+ | </ | ||
+ | |||
+ | </ | ||
+ | |||
+ | So that now the file contains: | ||
+ | |||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | | ||
+ | | ||
+ | </ | ||
+ | < | ||
+ | | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | | ||
+ | < | ||
+ | </ | ||
+ | |||
+ | |||
+ | </ | ||
+ | |||
+ | * In the file | ||
+ | |||
+ | < | ||
+ | $FEDORAHOME/ | ||
+ | |||
+ | we're going to add fulltext (and label) to the list of fields that are indexed and are therefore searchable. We do this by appending | ||
+ | |||
+ | < | ||
+ | ds.fulltext ds.label | ||
+ | </ | ||
+ | |||
+ | So that it now becomes: | ||
+ | |||
+ | < | ||
+ | |||
+ | The field ds.label and a document' | ||
+ | |||
+ | ===== Important notes===== | ||
+ | |||
+ | * Once installed, the FedoraGSearch rest url will by default be at: | ||
+ | < | ||
+ | If you visit this page, there are links to doing searches and browsing the Fedora repository' | ||
+ | * Make sure that upon installing Fedora Generic Search (whether using GSearchInstaller or installing manually), you either: | ||
+ | * choose to call your index **FedoraIndex** since this is what the demo-client expects by default, or | ||
+ | * create a file called gs3democlient.properties in the same folder as where the demo-client executable is, unless such a file already exists. Then in that properties file, write down the name of your index for the property // | ||
+ | < | ||
+ | If you had to create the properties file, you'd have to create this property as well. But if the file already existed, then the property // | ||
+ | * **IMPORTANT: | ||
+ | * text/html | ||
+ | * text/plain | ||
+ | * application/ | ||
+ | Text/xml is not accepted. (Therefore Greenstone documents exported to FedoraMETS and ingested into Fedora must be of one of the above MIME-types, else they will not be indexed by Fedora Generic Search.) | ||
+ | |||
+ | At present, FLI sets the content-type of the Fedora METS documents it exports to being text/xml. Therefore these documents don't yet get indexed by Fedora Generic Search. In order to do that, you need to use // |
en/developer/install_fedora_gsearch.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1