1 | ***********************************************************
|
---|
2 | README
|
---|
3 | ***********************************************************
|
---|
4 | Application: Greenstone 3 (QBR) web services demo-client
|
---|
5 |
|
---|
6 | Summary: Demo-client application in Java for the QBR (Query,
|
---|
7 | Browse and Retrieve) web services of Greenstone 3. Also
|
---|
8 | provides similar access to a Fedora repository of Greenstone
|
---|
9 | collections created by Greenstone's FLI application.
|
---|
10 |
|
---|
11 | This is a Java demonstration application for Greenstone 3
|
---|
12 | that presents a graphical user interface to Greenstone 3's
|
---|
13 | Query, Browsing and Retrieval functionality.
|
---|
14 |
|
---|
15 | The application allows one to search collections and browse
|
---|
16 | them by classifiers, displaying the results.
|
---|
17 |
|
---|
18 | It uses the new QBRSOAPServer web services of Greenstone 3
|
---|
19 | to access its search and (document and metadata) retrieval
|
---|
20 | operations, thereby demonstrating the use of Greenstone
|
---|
21 | 3's QBR web services.
|
---|
22 |
|
---|
23 | It also lets you browse Greenstone collections exported by
|
---|
24 | the FLI application into a Fedora repository. If Fedora
|
---|
25 | Generic Search is installed and if your "Fedora-Greenstone"
|
---|
26 | collections are indexed, some basic querying features will
|
---|
27 | be available in the demo-client's interface. A tool to help
|
---|
28 | install Fedora Generic Search once you have Fedora (2.2.1 or
|
---|
29 | greater) installed is included.
|
---|
30 |
|
---|
31 | Documentation on how to use the application, as well as
|
---|
32 | related matters like deploying the QBR web services and
|
---|
33 | using FLI can be found in the docs/HowToFiles folder when
|
---|
34 | the distribution is unzipped.
|
---|
35 |
|
---|
36 |
|
---|
37 | ***********************************************************
|
---|
38 | What you need and how to run
|
---|
39 | ***********************************************************
|
---|
40 | You need Java 1.5 or higher installed and JAVA_HOME set.
|
---|
41 | It runs on Windows XP (not tested on Vista yet) and Linux.
|
---|
42 |
|
---|
43 | A. If you've downloaded the zip file:
|
---|
44 | 1. Unzip it into a folder.
|
---|
45 | 2. Open an xterm and go into the folder where you extracted
|
---|
46 | it and type:
|
---|
47 | ./gs3democlient.sh
|
---|
48 | If you're on Windows, you can double-click on
|
---|
49 | gs3democlient.bat or otherwise open a DOS prompt, navigate
|
---|
50 | into the folder where you extracted the zip folder and type
|
---|
51 | gs3democlient.bat
|
---|
52 |
|
---|
53 |
|
---|
54 | B. If you've checked out the code and application from SVN,
|
---|
55 | you'll need JDK 5 as it is used to compile the code. To get
|
---|
56 | the application running from SVN:
|
---|
57 | 1. Go into the folder where you've checked it out into.
|
---|
58 | 2. (You'll need an internet connection for this step because
|
---|
59 | it will download the file CheckJavaVersion.java)
|
---|
60 | Open an x-term when on Linux or a DOS prompt when on windows
|
---|
61 | and type:
|
---|
62 | ant build-demo-client
|
---|
63 | This will generate the executable.
|
---|
64 | To run, type
|
---|
65 | ./gs3democlient.sh
|
---|
66 | on Linux and
|
---|
67 | gs3democlient.bat
|
---|
68 | if you're on windows. (If you've got JAVA_HOME pointing to
|
---|
69 | JDK 1.5, you can also double-click on gs3democlient.bat to
|
---|
70 | get it running.)
|
---|
71 |
|
---|
72 |
|
---|
73 | For detailed instructions, please refer to the html files
|
---|
74 | in the folder docs/HowToFiles |
---|