source: TI03-DataExtractor/trunk/dxc/manuals/install.html @ 794

Subversion URL: http://proj.badc.rl.ac.uk/svn/ndg/TI03-DataExtractor/trunk/dxc/manuals/install.html@794
Revision 794, 10.8 KB checked in by astephen, 13 years ago (diff)

Unstable but latest version with multi-variable support and split hooks
for CDML and CSML.

Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<HTML>
3<HEAD>
4        <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
5        <TITLE>Home Page</TITLE>
6        <META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.1  (Linux)">
7        <META NAME="CREATED" CONTENT="20060317;12440700">
8        <META NAME="CHANGED" CONTENT="20060317;13071000">
9        <META NAME="ProgId" CONTENT="FrontPage.Editor.Document">
10</HEAD>
11<BODY LANG="en-US" DIR="LTR">
12<H1>The Data Extractor (DX) Installation Guide</H1>
13<H2>Introduction</H2>
14<P>This document is one of a series of documents describing how to
15set up and use the Data Extractor (DX).  Further information is, or
16soon will be, available in the following guides:</P>
17<UL>
18        <LI><P STYLE="margin-bottom: 0cm"><B>DX Overview</B></P>
19        <LI><P STYLE="margin-bottom: 0cm"><B>DX Data Ingestion Guide</B> 
20        </P>
21        <LI><P STYLE="margin-bottom: 0cm"><B>DX Administrator's Guide</B> 
22        </P>
23        <LI><P STYLE="margin-bottom: 0cm"><B>DX User Guide</B> 
24        </P>
25        <LI><P><B>Guide to Securing the DX</B> 
26        </P>
27</UL>
28<H2>Where to get the DX package</H2>
29<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">The
30DX package can be downloaded from the NERC DataGrid web site at:</SPAN></P>
31<P STYLE="margin-bottom: 0cm"><BR>
32</P>
33<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><A HREF="http://ndg.nerc.ac.uk/dx">http://ndg.nerc.ac.uk/dx</A></SPAN></P>
34<P STYLE="margin-bottom: 0cm"><BR>
35</P>
36<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">The
37package contains both the DX-Server and DX-Client packages. Typically
38you will install both of these but you may only install one if you
39intend to interact with another existing service/application.</SPAN></P>
40<H2>Setting up the DX-Server</H2>
41<P STYLE="margin-bottom: 0cm">Below is a guide for installing and
42setting up the DX-Server package on your local machine.</P>
43<H3>Requirements and dependencies</H3>
44<P STYLE="margin-bottom: 0cm">Y<SPAN STYLE="background: transparent">ou
45will need the following to run DX-Server on your machine:</SPAN></P>
46<P STYLE="margin-bottom: 0cm"><BR>
47</P>
48<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>Operating
49System:</B> Unix/Linux (tested on RedHat 7.3 and SUSE 9.1).</SPAN></P>
50<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>Webserver:</B>
51Tested on Apache (comes as standard in Linux).</SPAN></P>
52<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>CDAT-3.3
53or greater: </B>Includes Python and VCS visualisation package.</SPAN></P>
54<P STYLE="margin-bottom: 0cm"><B><SPAN STYLE="background: transparent">ZSI
55SOAP Library:</SPAN></B><SPAN STYLE="font-weight: medium"><SPAN STYLE="background: transparent">
56 Version ***.</SPAN></SPAN></P>
57<H3>Contents of the DX package</H3>
58<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">When
59you (g)unzip and decompress (tar -xvf) the downloaded file you will
60find the following directories:</SPAN></P>
61<P STYLE="margin-bottom: 0cm"><BR>
62</P>
63<OL>
64        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">dxs_source/for_cgi_bin/
65        - this directory contains the one python module that controls the
66        package and acts as a CGI script (normally splatui.py). This must be
67        installed within the webserver's CGI area (or any directory visible
68        via the web with read and execute permission for files).</SPAN></P>
69        <P STYLE="margin-bottom: 0cm"></P>
70        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">dxs_source/for_local/
71        - this directory contains the actual DX-Server package itself and
72        can placed wherever you like (e.g.  /usr/local/dxs/). These are all
73        the modules that define the routines and objects called by the <I>dxui</I>
74        CGI script. This directory also contain various sub-directories:</SPAN></P>
75</OL>
76<UL>
77        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">
78           html/ - holds HTML page content for building a web interface.</SPAN></P>
79        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">
80           doc/ - holds documentation for DX-Server.</SPAN></P>
81</UL>
82<OL START=3>
83        <P STYLE="margin-bottom: 0cm"></P>
84        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">dxs_source/for_static_web/
85        - this directory contains the sub-directory dx_extra which in turn
86        holds the CSS style sheet for the web interface and the DX logo
87        under the logos directory.</SPAN></P>
88</OL>
89<P STYLE="margin-bottom: 0cm"><BR>
90</P>
91<H2>Setting up the DX-Server</H2>
92<P STYLE="margin-bottom: 0cm">Below is a guide for installing and
93setting up the DX-Server package on your local machine.</P>
94<H3>Requirements and dependencies</H3>
95<P STYLE="margin-bottom: 0cm">Y<SPAN STYLE="background: transparent">ou
96will need the following to run DX-Server on your machine:</SPAN></P>
97<P STYLE="margin-bottom: 0cm"><BR>
98</P>
99<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>Operating
100System:</B> Unix/Linux (tested on RedHat 7.3 and SUSE 9.1).</SPAN></P>
101<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>???Webserver:</B>
102Tested on Apache (comes as standard in Linux).</SPAN></P>
103<H3>Contents of the DX package</H3>
104<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">When
105you (g)unzip and decompress (tar -xvf) the downloaded file you will
106find the following directories:</SPAN></P>
107<P STYLE="margin-bottom: 0cm"><BR>
108</P>
109<OL START=4>
110        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">dxs_source/for_cgi_bin/
111        - this directory contains the one python module that controls the
112        package and acts as a CGI script (normally splatui.py). This must be
113        installed within the webserver's CGI area (or any directory visible
114        via the web with read and execute permission for files).</SPAN></P>
115        <P STYLE="margin-bottom: 0cm"></P>
116        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">dxs_source/for_local/
117        - this directory contains the actual DX-Server package itself and
118        can placed wherever you like (e.g.  /usr/local/dxs/). These are all
119        the modules that define the routines and objects called by the <I>dxui</I>
120        CGI script. This directory also contain various sub-directories:</SPAN></P>
121</OL>
122<UL>
123        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">
124           html/ - holds HTML page content for building a web interface.</SPAN></P>
125        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">
126           doc/ - holds documentation for DX-Server.</SPAN></P>
127</UL>
128<OL START=3>
129        <P STYLE="margin-bottom: 0cm"></P>
130        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">dxs_source/for_static_web/
131        - this directory contains the sub-directory dx_extra which in turn
132        holds the CSS style sheet for the web interface and the DX logo
133        under the logos directory.</SPAN></P>
134</OL>
135<P STYLE="margin-bottom: 0cm"><BR>
136</P>
137<H3>Trouble-shooting</H3>
138<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">The
139following problems may occur when installing the DX.</SPAN></P>
140<P STYLE="margin-bottom: 0cm"><BR>
141</P>
142<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>Problem</B>:
143The <I>dxui </I><SPAN STYLE="font-style: normal">script returns an
144error when called via a browser</SPAN>.</SPAN></P>
145<P STYLE="margin-bottom: 0cm"><BR>
146</P>
147<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>Solution</B>:
148Check the paths in the config.py file are all correct. Check that the
149main interface module (normally splatui.py) is in a directory that
150has read and execute permissions (normally cgi-bin). Check that the
151apache webserver is running. You might be able to run it using:
152/usr/sbin/apache2ctl -k start</SPAN></P>
153<P STYLE="margin-bottom: 0cm"><BR>
154</P>
155<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">Problem:
156Plots and animations have the top 20% cropped from the image. This
157was observed when tested on SUSE Linux 9.1.</SPAN></P>
158<P STYLE="margin-bottom: 0cm"><BR>
159</P>
160<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">Solution:
161Search for the following line in module plotClasses.py and uncomment
162it as follows:</SPAN></P>
163<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">CURRENT
164LINE:   # self.canvas.open()</SPAN></P>
165<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">REPLACE
166WITH:   self.canvas.open()</SPAN></P>
167<P STYLE="margin-bottom: 0cm"><BR>
168</P>
169<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">Problem:
170A python shelve error occurs such as:</SPAN></P>
171<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">Traceback
172(most recent call last):</SPAN></P>
173<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"> 
174File &quot;&lt;stdin&gt;&quot;, line 1, in ?</SPAN></P>
175<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"> 
176File &quot;/usr/local/cdat-3.3/lib/python2.2/shelve.py&quot;, line
177158, in open</SPAN></P>
178<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"> 
179  return DbfilenameShelf(filename, flag)</SPAN></P>
180<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"> 
181File &quot;/usr/local/cdat-3.3/lib/python2.2/shelve.py&quot;, line
182148, in __init__</SPAN></P>
183<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"> 
184  Shelf.__init__(self, anydbm.open(filename, flag))</SPAN></P>
185<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"> 
186File &quot;/usr/local/cdat-3.3/lib/python2.2/anydbm.py&quot;, line
18786, in open</SPAN></P>
188<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"> 
189  return mod.open(file, flag, mode)</SPAN></P>
190<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">gdbm.error:
191(2, 'No such file or directory')</SPAN></P>
192<P STYLE="margin-bottom: 0cm"><BR>
193</P>
194<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">Solution:
195In the interface module (normally splatui.py) add a line after the
196'sys' module has been imported:</SPAN></P>
197<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">sys.path.append('usr/lib/python2.2/lib-dynload')</SPAN></P>
198<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">If
199this does not work try locating the directory 'lib-dynload' under any
200python installation you have. Then add that diredtory path instead of
201that above.</SPAN></P>
202<P STYLE="margin-bottom: 0cm"><BR>
203</P>
204<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>Problem</B>:
205Errors occur saying that modules cannot be found.</SPAN></P>
206<P STYLE="margin-bottom: 0cm"><BR>
207</P>
208<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>Solution</B>:
209Check that all the paths are correct in the <I>serverConfig.py
210</I>module.</SPAN></P>
211<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">&nbsp;</SPAN></P>
212<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">&nbsp;</SPAN></P>
213<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">&nbsp;</SPAN></P>
214</BODY>
215</HTML>
Note: See TracBrowser for help on using the repository browser.