source: gs3-extensions/vishnu/trunk/README@ 24331

Last change on this file since 24331 was 9874, checked in by kjdon, 19 years ago

merged from branch ant-install-branch: merge 1

  • Property svn:keywords set to Author Date Id Revision
File size: 4.3 KB
Line 
1Vishnu package for ...
2
3If you are running this as part of Greenstone, just installing Greenstone will install Vishnu.
4
5If you want to run it standalone:
6
7You need to have Java 1.4 or higher and Ant installed. The environment variable JAVA_HOME needs to be set.
8You need to have MG installed - this should be the version from Greenstone, and you need the mg.jar file in your CLASSPATH and the libmgjni.so in your LD_LIBRARY_PATH.
9You need the lucene 1.4 or higher jar file in your CLASSPATH.
10Other jar files needed in CLASSPATH: xercesImpl.jar, servlet-api.jar.
11These jar files all come as part of the Greenstone download. Some in gsdl3/lib/java, and servlet.jar in gsdl3/comms/jakarta/tomcat/lib (when unpacked).
12
13Edit the build.xml file and change the prefix property to be the current directory.
14
15Then run 'ant' (or "ant all').
16
17
18COLLECTION BUILDING:
19
20Make a directory called collections inside the main vishnu directory. Inside this, create a new directory for your collection. The name of this directory is the collection identifier. Inside the collection directory create a new direcotry called import. Inside here put all the documents that you want in your collection. Documents must be plain text, xml or html.
21
22Then you can build the collection:
23
24Command line:
25java vishnu.builder.CollectionBuilder -collsHome (directory where collections live: path-to-vishnu/collections) -collection (directory name of collection) -name (descriptive name for collection) -description (collection description) -index ("mg" or "luc")
26
27If you want to use views, add the option "-use-views" to the above command. This will create a separate index for each sub-directory in the import folder, and you can search each sub-view independently.
28
29Using a GUI tool:
30java vishnu.builder.IndexerGUI
31
32Fill in the fields as appropriate, and click "Start indexing".
33
34Once the collection is built, you need to rename the building directory to index. Collections are built into the building directory, but served from the index directory. This allows you to serve a built collection while rebuilding.
35
36For collections in the Greenstone 3 context, you will need to create the files etc/collectionConfig.xml and index/buildConfig.xml.
37These should look like the following:
38
39etc/collectionConfig.xml:
40<collectionConfig>
41 <metadataList>
42 <metadata name="creator">creator's email address</metadata>
43 </metadataList>
44 <displayItemList>
45 <displayItem name='name' lang='en'>Collection name</displayItem>
46 <displayItem name='description' lang='en'>Collection description
47 </displayItem>
48 </displayItemList>
49</collectionConfig>
50
51index/buildConfig.xml:
52<buildConfig>
53 <metadataList/>
54 <serviceRackList>
55 <serviceRack name="Visualizer">
56 <engineType name="MG"/> <!-- or LUCENE, depending on how you built the collection -->
57 </serviceRack>
58 </serviceRackList>
59</buildConfig>
60
61Note that you cannot use views in the Greenstone context yet.
62
63RUNNING THE SERVLET:
64
65
66If you are running this standalone, you need to run a servlet container for VisServlet.
67We have provided an example configuration for use with Tomcat (version 4.1).
68
69The vishnu/web directory is setup to be the context directory for vishnu in Tomcat.
70You need to edit Tomcat's conf/server.xml file, and add in the context for vishnu. Add the following element after the tomcat root context element:
71
72<Context path="/vishnu" docBase="full-path-to-vishnu/web" debug="1" reloadable="true"><Resources allowLinking='true'/></Context>
73(replacing "full path-to-vishnu" with the path to the vishnu directory.)
74Edit the vishnu/web/WEB-INF/web.xml file and put in the correct path to your collections directory.
75
76The vishnu.jar file needs to be in your CLASSPATH, and make sure that Tomcat is using your CLASSPATH.
77
78RUNNING THE APPLET:
79
80The file vishnu/web/index.html is an introductory page about vishnu, and contains the applet. Make sure that the library parameter has the correct address for your visualiser servlet. The default is http://localhost:8080/vishnu/server. This will be correct if you have installed Tomcat to use port 8080, and have set the vishnu servlet up as described above. But note, if you are using Mozilla, it may not like localhost here, so if you have problems, try putting the full name of the server running Tomcat in place of localhost.
81
82If you are running Tomcat as described above, you can view this index file at http://localhost:8080/vishnu/index.html
Note: See TracBrowser for help on using the repository browser.