source: trunk/gsdl3/packages/vishnu/README@ 8405

Last change on this file since 8405 was 8405, checked in by kjdon, 20 years ago

small changes

  • Property svn:keywords set to Author Date Id Revision
File size: 4.3 KB
Line 
1Vishnu package for ...
2
3LINUX INSTALL:
4
5If you are running this as part of Greenstone, just installing Greenstone will install Vishnu.
6
7If you want to run it standalone:
8
9The environment variable JAVA_HOME needs to be set.
10You 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.
11You need the lucene 1.4 or higher jar file in your CLASSPATH.
12Other jar files needed in CLASSPATH: xercesImpl.jar, servlet.jar.
13
14Edit the src/vishnu Makefile and uncomment the prefix for stand-alone vishnu.
15
16Then run the following:
17
18make
19make install
20
21WINDOWS INSTALL:
22
23Doesn't work on windows yet.
24
25COLLECTION BUILDING:
26
27Make 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.
28
29Then you can build the collection:
30
31Command line:
32java 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")
33
34If 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.
35
36Using a GUI tool:
37java vishnu.builder.IndexerGUI
38
39Fill in the fields as appropriate, and click "Start indexing".
40
41Once 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.
42
43For collections in the Greenstone 3 context, you will need to create the files etc/collectionConfig.xml and index/buildConfig.xml.
44These should look like the following:
45
46etc/collectionConfig.xml:
47<collectionConfig>
48 <metadataList>
49 <metadata name="creator">creator's email address</metadata>
50 </metadataList>
51 <displayItemList>
52 <displayItem name='name' lang='en'>Collection name</displayItem>
53 <displayItem name='description' lang='en'>Collection description
54 </displayItem>
55 </displayItemList>
56</collectionConfig>
57
58index/buildConfig.xml:
59<buildConfig>
60 <metadataList/>
61 <serviceRackList>
62 <serviceRack name="Visualizer">
63 <engineType name="MG"/> <!-- or LUCENE, depending on how you built the collection -->
64 </serviceRack>
65 </serviceRackList>
66</buildConfig>
67
68Note that you cannot use views in the Greenstone context yet.
69
70RUNNING THE SERVLET:
71
72
73If you are running this standalone, you need to run a servlet container for VisServlet.
74We have provided an example configuration for use with Tomcat (version 4.1).
75
76Set the prefix in the src/vishnu Makefile to be ../.., then the servlet class and jar files will be installed in the correct places.
77The vishnu/web directory is setup to be the context directory for vishnu in Tomcat.
78You 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:
79
80<Context path="/vishnu" docBase="full-path-to-vishnu/web" debug="1" reloadable="true"><Resources allowLinking='true'/></Context>
81(replacing "full path-to-vishnu" with the path to the vishnu directory.)
82Edit the vishnu/web/WEB-INF/web.xml file and put in the correct path to your collections directory.
83
84The vishnu.jar file needs to be in your CLASSPATH, and make sure that Tomcat is using your CLASSPATH.
85
86RUNNING THE APPLET:
87
88The 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.
89
90If 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.