source: MILK/trunk/milk_server/README.txt @ 5261

Subversion URL: http://proj.badc.rl.ac.uk/svn/ndg/MILK/trunk/milk_server/README.txt@5931
Revision 5261, 4.1 KB checked in by cbyrom, 11 years ago (diff)

Lots of tidy ups to MILK codebase:

Implement new input search filters - with javascript datapickers to
pick the date ranges + add the vocab search ahead text input and
combine this with the text input.

Refactor discovery controller to tidy it up significantly - making more
structured and improving error handling and logging. Improve
templates for the search filter, splitting into multiple files to
organise better.

Various tidying up and tweaks of other codebase - e.g. standardising
use of global variables across app.

Line 
1Prerequisites
2==================
3The following should be installed to run the ojims editor:
41. Python2.5 - see http://www.python.org/download/
52. Pylons - see http://docs.pythonweb.org/display/pylonsdocs/Installing+Pylons
63. Genshi - see http://genshi.edgewall.org/wiki/Download
74. FormEncode - see http://www.formencode.org/download.html
85. ndgCommon - see http://proj.badc.rl.ac.uk/ndg/browser/ndgCommon
9
10NB, it is easier to setup the prereqs by using easy_install - http://peak.telecommunity.com/DevCenter/EasyInstall
11- then you can just run, easy_install pylons, easy_install genshi, etc.
12
13Installation and Setup
14======================
15Once the prereqs are installed and the codebase is extracted to a local:
16
17i) Copy the development.ini, helpText.config and milk.config files in the top level MILK
18directory to the milk_server directory below
19ii) Adjust the content of these files as follows:
20
21development.ini
22- adjust the host and port settings appropriately
23- turn debug on/off
24- adjust logging level of server output (adjust the logger_root settings)
25
26milk.config
27adjust:
28[DEFAULT]
29- server - NB, this should match the host and port settings in the development.ini file
30- mailServer - SMTP server to sending mails
31- metadataMaintainer - email address to which correction comments will be mailed
32- tbrecipient mail address to which trackback comments are sent
33- proxyServer - proxy server to use, if required
34- debug - for more verbose logging
35[SEARCH]
36- discoveryURL - url to discovery service; defaults to discovery service on the current stack
37
38[WMC_CLIENT]
39- url - if a WMC client is to be used to retrieve data for visualisation purposes, specify
40the url to it here
41
42[NDG_B_SERVICE]
43 - add details of providers and their associated browse services, to be exposed by this
44 browse service - format: 'provider ID: hostname'
45 
46[NDG_EXIST]
47- add appropriate eXist DB servers and the providers which they serve
48- passwordFile - specify password file with content format:
49
50'db host name' 'user ID' 'password'
51
52[DISCOVERY]
53- discoveryServiceURL - if a different discovery service is to be used from the default
54one (defined in ndg.common.src.clients.ws.discovery.discoveryserviceclient)
55
56[MILK_SERVER]
57- configure the MILK stack to provide editor, browse, discovery, or any combination of the
58three, services
59
60helpText.config
61Adjust any of the help text contain in the file to suit purpose.  NB, any help text
62here is set on the globals object as a new field - e.g. having a line,
63'
64blah: some help text
65'
66in this file will set up data on the globals variable so that:
67
68g.blah will output, 'some help text' when used.
69
70
71iii) From the milk_server directory, run:
72
73paster serve --reload development.ini
74
75Vocab server autocomplete client
76-------------------
77Also included in the codebase is a client for doing ajax based autocomplete vocab
78term searches against a vocab server for an input text field.  Details on how
79to set this up for use are available in milk_server/controllers/vocabsearch/README.txt.
80
81Further Notes
82-----------------
83i) The editor uses the browse service under the covers, so if this is enabled, browse
84functionality will also be available
85ii) Browse links exposed by searches in the discovery service are generated using the
86results from the discovery service; if these are invalid, it is likely that the moles
87data has not been properly passed along the pipeline from document publication to
88ingestion in the discovery service
89(NB, for info on how the discovery ingest works, see:
90
91http://proj.badc.rl.ac.uk/badc/wiki/opman/FeedHarvester and
92http://proj.badc.rl.ac.uk/badc/wiki/opman/OAIIngester
93
94TODO
95--------------
96i) The retrieve controller which represents the browse service is very ropey and could do
97with a lot of tidying up
98ii) The discovery controller which represents the discovery service is very ropey and
99could do with a lot of tidying up
100iii) Implementation of new security layer; this is being developed by Phil Kershaw and
101should sit on top of the MILK stack without any extra modification.  When it is available,
102the existing security code should be entirely removed, as it currently is not doing anything.
103
Note: See TracBrowser for help on using the repository browser.