source: TI03-DataExtractor/trunk/INSTALL.txt @ 1109

Subversion URL: http://proj.badc.rl.ac.uk/svn/ndg/TI03-DataExtractor/trunk/INSTALL.txt@1356
Revision 1109, 3.0 KB checked in by astephen, 14 years ago (diff)

Stable-ish version with fully-ish working dxc client.

Line 
1Basic installation notes for the Data Extractor (DX)
2====================================================
3
4The setup for the DX has been written to be as easy as possible. If
5you are installing both the server (dxs) and client (dxc) packages
6there are various components that need to be installed in different
7locations. These components should all be installed automatically once
8you have configured the installation process by modifying the contents
9of the "install.conf" file. Note that you will need to have permission
10to create directories and files in all the directories that you specify
11for in your configuration file.
12
13Please follow the instructions below to install the DX package(s):
14
151. Download the source (you'll have it if you are reading this).
16
172. Place the source file in a directory where you will control the
18installation from, e.g. /usr/local/src.
19
203. Extract the contents of the tar file:
21
22    tar -xvf dx-${version}-all.tar
23   
244. Then extract the parts you intend to build:
25
26  (i) Both server and client:
27 
28    tar -xvzf pydxs-${version}.tar.gz
29    tar -xvzf pydxc-${version}.tar.gz   
30
31  (ii) Server only:
32
33    tar -xvzf pydxs-${version}.tar.gz
34   
35  (iii) Client only:
36 
37    tar -xvzf pydxc-${version}.tar.gz
38
395. Copy the configuration file to a backup version:
40
41    cp install.conf install.conf.bak
42   
436. Manually edit the "install.conf" configuration file using a standard editor.
44
457. Change directory to the appropriate sub-directory:
46
47   (i) Both server and client:
48   
49     cd pydxs-${version}
50   
51   (ii) Server only:
52   
53     cd pydxs-${version}
54   
55   (iii) Client only:
56   
57     cd pydxc-${version}
58
598. Run the setup script in the directory you have entered:
60
61    <your_python>/python setup.py install
62   
63   Where <your_python> is the path of the python version that CDAT is
64   installed under and the you want the DX package(s) to run under.
65   
66   This script will prompt you to confirm that you want to create or
67   overwrite the directories you have specified.
68
69Now, fingers crossed, you have successfully installed the Data
70Extractor on your machine.
71
72Testing your installation
73=========================
74
75If you have installed both the server and the client then you should
76be able to view the CGI User Interface at the URL you provided in the
77"install.conf" configuration file. Before you visit the URL you should
78start the DX server's Web Service. This file is installed as the
79python script:
80
81dxs/bin/DXWSInterface.py
82
83You would typically run this script in the background as it should run
84continuously when you want the DX server to be available:
85
86<BASEDIR>/dxs/bin/DXWSInterface.py &
87
88Once this is running you should open a browser and visit the URL of
89your DX client User Interface (typically called "dxui"). If both
90server and client are working then you should be able to select some
91example data from the test datasets to demonstrate the workings of the
92DX.
93
94If you have any problems, suggestions or issues please contact Ag
95Stephens <a.stephens@rl.ac.uk>.
96
97Ag Stephens, 10/04/2006.
98
Note: See TracBrowser for help on using the repository browser.