T03_DataExtractor: install.html

File install.html, 21.1 KB (added by astephen, 13 years ago)

DX Installation Manual

Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<HTML><HEAD><TITLE>Home Page</TITLE>
3<META http-equiv=CONTENT-TYPE content="text/html; charset=utf-8">
4<META content="MSHTML 6.00.2900.2802" name=GENERATOR>
5<META content=20060317;12440700 name=CREATED>
6<META content=20060413;21021300 name=CHANGED>
7<META content=FrontPage.Editor.Document name=ProgId></HEAD>
8<BODY lang=en-US dir=ltr>
9<H1>The Data Extractor (DX) Installation Guide</H1>
10<H2>Introduction</H2>
11<P>This document is one of a series of documents describing how to set up and
12use the Data Extractor (DX). Further information is, or soon will be, available
13in the following guides:</P>
14<UL>
15  <LI>
16  <P style="MARGIN-BOTTOM: 0cm"><B>DX Overview</B></P>
17  <LI>
18  <P style="MARGIN-BOTTOM: 0cm"><B>DX Data Ingestion Guide</B> </P>
19  <LI>
20  <P style="MARGIN-BOTTOM: 0cm"><B>DX Administrator's Guide</B> </P>
21  <LI>
22  <P style="MARGIN-BOTTOM: 0cm"><B>DX User Guide</B> </P>
23  <LI>
24  <P><B>Guide to Securing the DX</B> </P></LI></UL>
25<H2>Where to get the DX package</H2>
26<P style="MARGIN-BOTTOM: 0cm"><SPAN 
27style="BACKGROUND: none transparent scroll repeat 0% 0%">The DX package can be
28downloaded from the NERC DataGrid web site at:</SPAN></P>
29<P style="MARGIN-BOTTOM: 0cm"><BR></P>
30<P style="MARGIN-BOTTOM: 0cm"><A href="http://ndg.nerc.ac.uk/dx"><SPAN 
31style="BACKGROUND: none transparent scroll repeat 0% 0%">http://ndg.nerc.ac.uk/dx</SPAN></A></P>
32<P style="MARGIN-BOTTOM: 0cm"><BR></P>
33<P style="MARGIN-BOTTOM: 0cm"><SPAN 
34style="BACKGROUND: none transparent scroll repeat 0% 0%">The package contains
35both the DX-Server and DX-Client packages. Typically you will install both of
36these but you may only install one if you intend to interact with another
37existing service/application.</SPAN></P>
38<H2>Setting up the DX-Server</H2>
39<P style="MARGIN-BOTTOM: 0cm">Below is a guide for installing and setting up the
40DX-Server package on your local machine.</P>
41<H3>Requirements and dependencies</H3>
42<P style="MARGIN-BOTTOM: 0cm">Y<SPAN 
43style="BACKGROUND: none transparent scroll repeat 0% 0%">ou will need the
44following to run DX-Server on your machine:</SPAN></P>
45<P style="MARGIN-BOTTOM: 0cm"><BR></P>
46<P style="MARGIN-BOTTOM: 0cm"><SPAN 
47style="BACKGROUND: none transparent scroll repeat 0% 0%"><B>Operating
48System:</B> Unix/Linux (tested on RedHat 7.3 and SUSE 9.1).</SPAN></P>
49<P style="MARGIN-BOTTOM: 0cm"><SPAN 
50style="BACKGROUND: none transparent scroll repeat 0% 0%"><B>Apache
51Webserver:</B> Tested on Apache (comes as standard with Linux).</SPAN></P>
52<P style="MARGIN-BOTTOM: 0cm"><SPAN 
53style="BACKGROUND: none transparent scroll repeat 0% 0%"><B>CDAT-4.0 or greater:
54</B>Includes Python and VCS visualisation package.</SPAN></P>
55<P style="MARGIN-BOTTOM: 0cm"><SPAN 
56style="BACKGROUND: none transparent scroll repeat 0% 0%"><B>ZSI SOAP Library
57Version 1.7 or greater:</B> Used to call and create Web Service SOAP
58interface.</SPAN></P>
59<P style="MARGIN-BOTTOM: 0cm"><BR></P>
60<H3 style="MARGIN-TOP: 0cm; MARGIN-BOTTOM: 0cm"><SPAN 
61style="BACKGROUND: none transparent scroll repeat 0% 0%">Installing the external
62packages</SPAN></H3>
63<P style="MARGIN-BOTTOM: 0cm"><BR></P>
64<P style="MARGIN-BOTTOM: 0cm"><B>Apache Web Server</B></P>
65<P style="MARGIN-BOTTOM: 0cm">On many flavours of Unix/Linux an Apache web
66server will already be installed in which case it is normally just a case of
67starting it and finding out where the “htdocs” and “cgi-bin” directories are. On
68standard installs you might find these in one of following directories:</P>
69<P style="MARGIN-BOTTOM: 0cm"><BR></P>
70<P style="MARGIN-BOTTOM: 0cm">/var/www/</P>
71<P style="MARGIN-BOTTOM: 0cm">/srv/www/</P>
72<P style="MARGIN-BOTTOM: 0cm"><BR></P>
73<P style="MARGIN-BOTTOM: 0cm">If you have to install apache yourself you'll need
74to collect the source code from:</P>
75<P style="MARGIN-BOTTOM: 0cm"><BR></P>
76<P style="MARGIN-BOTTOM: 0cm"><A 
77href="http://httpd.apache.org/download.cgi">http://httpd.apache.org/download.cgi</A></P>
78<P style="MARGIN-BOTTOM: 0cm"><BR></P>
79<P style="MARGIN-BOTTOM: 0cm">Get the latest copy, I downloaded the file
80“httpd-2.2.0.tar.gz” to my /src/ directory (but you can put it anywhere).</P>
81<P style="MARGIN-BOTTOM: 0cm"><BR></P>
82<P style="MARGIN-BOTTOM: 0cm">Installing it was incredibly simple (these guys
83know what they are doing!)...the only thing you'll need to do is decide where to
84install your web server.</P>
85<P style="MARGIN-BOTTOM: 0cm"><BR></P>
86<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">gunzip
87httpd-2.2.0.tar.gz</FONT></P>
88<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">tar -xvf
89httpd-2.2.0.tar</FONT></P>
90<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">cd
91httpd-2.2.0</FONT></P>
92<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">mkdir
93&lt;MY_WEBSERVER_LOCATION&gt;</FONT></P>
94<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">./configure
95–prefix=&lt;MY_WEBSERVER_LOCATION&gt;</FONT></P>
96<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">make</FONT></P>
97<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">make
98install</FONT></P>
99<P style="MARGIN-BOTTOM: 0cm"><BR></P>
100<P style="MARGIN-BOTTOM: 0cm"><FONT face="Nimbus Roman No9 L">Then you can start
101the web server with:</FONT></P>
102<P style="MARGIN-BOTTOM: 0cm"><BR></P>
103<P style="MARGIN-BOTTOM: 0cm"><FONT 
104face="Courier, monospace">&lt;MY_WEBSERVER_LOCATION&gt;/bin/apachectl
105start</FONT></P>
106<P style="MARGIN-BOTTOM: 0cm"><BR></P>
107<P style="MARGIN-BOTTOM: 0cm"><FONT face="Nimbus Roman No9 L">You should then be
108able to view the top level web page via a browser at:</FONT></P>
109<P style="MARGIN-BOTTOM: 0cm"><BR></P>
110<P style="MARGIN-BOTTOM: 0cm"><FONT 
111face="Nimbus Roman No9 L">http://&lt;YOUR_MACHINE_NAME&gt;/index.html</FONT></P>
112<P style="MARGIN-BOTTOM: 0cm"><BR></P>
113<P style="MARGIN-BOTTOM: 0cm"><FONT face="Nimbus Roman No9 L">If you cannot see
114this file then you may have a port error (e.g. if port 80 is blocked on your
115system). You might be able to get around this by editing the “httpd.conf”
116configuration file at:</FONT></P>
117<P style="MARGIN-BOTTOM: 0cm"><BR></P>
118<P style="MARGIN-BOTTOM: 0cm"><FONT 
119face="Courier, monospace">&lt;MY_WEBSERVER_LOCATION&gt;/conf/httpd.conf</FONT></P>
120<P style="MARGIN-BOTTOM: 0cm"><BR></P>
121<P style="MARGIN-BOTTOM: 0cm"><FONT face="Nimbus Roman No9 L">In this file you
122can search for the word “Listen” and change the setting 80 to another number (I
123used 8080, not sure why). Once done your webserver top page will be visible
124at:</FONT></P>
125<P style="MARGIN-BOTTOM: 0cm"><BR></P>
126<P style="MARGIN-BOTTOM: 0cm"><FONT 
127face="Nimbus Roman No9 L">http://&lt;YOUR_MACHINE_NAME&gt;:8080/index.html -
128where 8080 is the port you chose to listen on.</FONT></P>
129<P style="MARGIN-BOTTOM: 0cm"><BR></P>
130<P style="MARGIN-BOTTOM: 0cm"><FONT face="Nimbus Roman No9 L">In order to pick
131up this change you might have to stop and restart the server with:</FONT></P>
132<P style="MARGIN-BOTTOM: 0cm"><BR></P>
133<P style="MARGIN-BOTTOM: 0cm"><FONT 
134face="Courier, monospace">&lt;MY_WEBSERVER_LOCATION&gt;/bin/apachectl
135stop</FONT></P>
136<P style="MARGIN-BOTTOM: 0cm"><FONT 
137face="Courier, monospace">&lt;MY_WEBSERVER_LOCATION&gt;/bin/apachectl
138start</FONT></P>
139<P style="MARGIN-BOTTOM: 0cm"><BR></P>
140<P style="MARGIN-BOTTOM: 0cm"><FONT face="Nimbus Roman No9 L">This file should
141be located at:</FONT></P>
142<P style="MARGIN-BOTTOM: 0cm"><BR></P>
143<P style="MARGIN-BOTTOM: 0cm"><FONT 
144face="Courier, monospace">&lt;MY_WEBSERVER_LOCATION&gt;/htdocs/index.html</FONT></P>
145<P style="MARGIN-BOTTOM: 0cm"><BR></P>
146<P style="MARGIN-BOTTOM: 0cm"><FONT face="Nimbus Roman No9 L">The location of
147your “cgi-bin” directory should be:</FONT></P>
148<P style="MARGIN-BOTTOM: 0cm"><BR></P>
149<P style="MARGIN-BOTTOM: 0cm"><FONT 
150face="Courier, monospace">&lt;MY_WEBSERVER_LOCATION&gt;/cgi-bin/</FONT></P>
151<P style="MARGIN-BOTTOM: 0cm"><BR></P>
152<P style="MARGIN-BOTTOM: 0cm"><SPAN><FONT face="Nimbus Roman No9 L">You should
153be able to write any cgi script and place it in the above directory with 755
154permissions and will run.</FONT></SPAN></P>
155<P style="MARGIN-BOTTOM: 0cm"><BR></P>
156<P style="MARGIN-BOTTOM: 0cm"><B>CDAT</B></P>
157<P style="MARGIN-BOTTOM: 0cm">CDAT (Climate Data Analysis Tools) is a large
158package that binds a set of sub-packages together under a common python
159interface. If you are a serious linux/unix/python-head you might want to try
160installing selected parts of CDAT to fit in with your existing installations.
161However, most people prefer to follow the simple and recommended installation of
162CDAT as follows:</P>
163<P style="MARGIN-BOTTOM: 0cm"><BR></P>
164<OL>
165  <LI>
166  <P style="MARGIN-BOTTOM: 0cm">Download the “everything” source from:</P>
167  <P style="MARGIN-BOTTOM: 0cm"><A 
168  href="http://www-pcmdi.llnl.gov/software-portal/cdat/download/">http://www-pcmdi.llnl.gov/software-portal/cdat/download/</A></P></LI></OL>
169<P style="MARGIN-BOTTOM: 0cm"><SPAN>This will typically have a name
170like:</SPAN></P>
171<P style="MARGIN-BOTTOM: 0cm">CDAT-4.0-everything.tar.gz </P>
172<P style="MARGIN-BOTTOM: 0cm"><BR></P>
173<OL start=2>
174  <LI>
175  <P style="MARGIN-BOTTOM: 0cm">Install using:</P></LI></OL>
176<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">gunzip
177CDAT-4.0-everything.tar.gz</FONT></P>
178<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">tar -xvf
179CDAT-4.0-everything.tar</FONT></P>
180<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">cd
181CDAT-4.0/</FONT></P>
182<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">mkdir
183&lt;MY_CDAT_LOCATION&gt;</FONT></P>
184<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">unset
185PYTHONPATH</FONT></P>
186<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">./express_install
187&lt;MY_CDAT_LOCATION&gt; --disable_opendap</FONT></P>
188<P style="MARGIN-BOTTOM: 0cm"><BR></P>
189<P style="MARGIN-BOTTOM: 0cm">Note that you will have to decide where to put
190your CDAT installation but “/usr/local/cdat” is very common. This has python
191installed as part of it. You would normally put the python version in a priority
192position in your PATH environment variable:</P>
193<P style="MARGIN-BOTTOM: 0cm"><BR></P>
194<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">export
195PATH=&lt;MY_CDAT_LOCATION&gt;:$PATH</FONT></P>
196<P style="MARGIN-BOTTOM: 0cm"><BR></P>
197<P style="MARGIN-BOTTOM: 0cm"><B>ZSI SOAP LIbrary</B></P>
198<P style="MARGIN-BOTTOM: 0cm">ZSI is the python Zolera SOAP Infrastructure which
199is documented at:</P>
200<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace"><A 
201href="http://pywebsvcs.sourceforge.net/zsi.html">http://pywebsvcs.sourceforge.net/zsi.html</A></FONT></P>
202<P style="MARGIN-BOTTOM: 0cm"><BR></P>
203<P style="MARGIN-BOTTOM: 0cm">ZSI is used by the DX server and client packages
204to communicate using the Simple Object Access Protocol (SOAP). It is very
205straightforward to install ZSI:</P>
206<P style="MARGIN-BOTTOM: 0cm"><BR></P>
207<OL>
208  <LI>
209  <P style="MARGIN-BOTTOM: 0cm">Get the source:</P></LI></OL>
210<P style="MARGIN-BOTTOM: 0cm"><FONT 
211face="Courier, monospace">http://pywebsvcs.sourceforge.net/</FONT></P>
212<P style="MARGIN-BOTTOM: 0cm"><BR></P>
213<P style="MARGIN-BOTTOM: 0cm">2. Build the package:</P>
214<P style="MARGIN-BOTTOM: 0cm"><BR></P>
215<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">gunzip
216ZSI-1.7.tar.gz </FONT></P>
217<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">tar -xvf
218ZSI-1.7.tar</FONT></P>
219<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">cd
220ZSI-1.7/</FONT></P>
221<P style="MARGIN-BOTTOM: 0cm"><FONT 
222face="Courier, monospace">&lt;MY_CDAT_LOCATION&gt;/bin/python setup.py install
223</FONT></P>
224<P style="MARGIN-BOTTOM: 0cm"><BR></P>
225<P style="MARGIN-BOTTOM: 0cm"><B>Note: </B><SPAN>If you problems running ZSI you
226may need to install a recent version of the PyXML library. This is the case if
227you get the error: </SPAN></P>
228<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">from
229xml.dom.ext.reader import PyExpat</FONT></P>
230<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">ImportError: No
231module named ext.reader</FONT></P>
232<P style="MARGIN-BOTTOM: 0cm"><BR></P>
233<P style="MARGIN-BOTTOM: 0cm">If you need to build PyXML it should happen as
234follows:</P>
235<P style="MARGIN-BOTTOM: 0cm"><BR></P>
236<OL>
237  <LI>
238  <P style="MARGIN-BOTTOM: 0cm">Get the source from:</P>
239  <P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace"><A 
240  href="http://pyxml.sourceforge.net/">http://pyxml.sourceforge.net/</A></FONT></P></LI></OL>
241<P style="MARGIN-BOTTOM: 0cm"><BR></P>
242<OL start=2>
243  <LI>
244  <P style="MARGIN-BOTTOM: 0cm"><SPAN 
245  style="BACKGROUND: none transparent scroll repeat 0% 0%">Build as
246  follows:</SPAN></P></LI></OL>
247<P style="MARGIN-BOTTOM: 0cm"><BR></P>
248<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">gunzip
249PyXML-0.8.4.tar.gz </FONT></P>
250<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">tar -xvf
251PyXML-0.8.4.tar</FONT></P>
252<P style="MARGIN-BOTTOM: 0cm"><FONT face="Courier, monospace">cd
253PyXML-0.8.4/</FONT></P>
254<P style="MARGIN-BOTTOM: 0cm"><SPAN 
255style="BACKGROUND: none transparent scroll repeat 0% 0%"><SPAN><FONT 
256face="Courier, monospace">&lt;MY_CDAT_LOCATION&gt;/bin/python setup.py install
257</FONT></SPAN></SPAN></P>
258<H3>Contents of the DX package</H3>
259<P style="MARGIN-BOTTOM: 0cm"><SPAN 
260style="BACKGROUND: none transparent scroll repeat 0% 0%">When you (g)unzip and
261decompress (tar -xvf) the downloaded file you will find the following
262directories:</SPAN></P>
263<P style="MARGIN-BOTTOM: 0cm"><BR></P>
264<P style="MARGIN-BOTTOM: 0cm">py</P>
265<P style="MARGIN-BOTTOM: 0cm">web</P>
266<P style="MARGIN-BOTTOM: 0cm">main</P>
267<P style="MARGIN-BOTTOM: 0cm">cgi</P>
268<P style="MARGIN-BOTTOM: 0cm">cgi dxc install.conf INSTALL.txt pydxc README.txt
269web_extras</P>
270<P style="MARGIN-BOTTOM: 0cm">dist dxs install.sh MANIFEST pydxs setup.py</P>
271<P style="MARGIN-BOTTOM: 0cm"><BR></P>
272<OL>
273  <LI>
274  <P style="MARGIN-BOTTOM: 0cm"><SPAN 
275  style="BACKGROUND: none transparent scroll repeat 0% 0%">dxs_source/for_cgi_bin/
276  - this directory contains the one python module that controls the package and
277  acts as a CGI script (normally splatui.py). This must be installed within the
278  webserver's CGI area (or any directory visible via the web with read and
279  execute permission for files).</SPAN></P>
280  <LI>
281  <P style="MARGIN-BOTTOM: 0cm"><SPAN 
282  style="BACKGROUND: none transparent scroll repeat 0% 0%">dxs_source/for_local/
283  - this directory contains the actual DX-Server package itself and can placed
284  wherever you like (e.g. /usr/local/dxs/). These are all the modules that
285  define the routines and objects called by the <I>dxui</I> CGI script. This
286  directory also contain various sub-directories:</SPAN></P></LI></OL>
287<UL>
288  <LI>
289  <P style="MARGIN-BOTTOM: 0cm"><SPAN 
290  style="BACKGROUND: none transparent scroll repeat 0% 0%">html/ - holds HTML
291  page content for building a web interface.</SPAN></P>
292  <LI>
293  <P style="MARGIN-BOTTOM: 0cm"><SPAN 
294  style="BACKGROUND: none transparent scroll repeat 0% 0%">doc/ - holds
295  documentation for DX-Server.</SPAN></P></LI></UL>
296<OL start=3>
297  <LI>
298  <P style="MARGIN-BOTTOM: 0cm"><SPAN 
299  style="BACKGROUND: none transparent scroll repeat 0% 0%">dxs_source/for_static_web/
300  - this directory contains the sub-directory dx_extra which in turn holds the
301  CSS style sheet for the web interface and the DX logo under the logos
302  directory.</SPAN></P></LI></OL>
303<P style="MARGIN-BOTTOM: 0cm"><BR></P>
304<H2>Setting up the DX-Server</H2>
305<P style="MARGIN-BOTTOM: 0cm">Basic installation notes for the Data Extractor
306(DX)</P>
307<P 
308style="MARGIN-BOTTOM: 0cm">====================================================</P>
309<P style="MARGIN-BOTTOM: 0cm"><BR></P>
310<P style="MARGIN-BOTTOM: 0cm">The setup for the DX has been written to be as
311easy as possible. If</P>
312<P style="MARGIN-BOTTOM: 0cm">you are installing both the server (dxs) and
313client (dxc) packages</P>
314<P style="MARGIN-BOTTOM: 0cm">there are various components that need to be
315installed in different</P>
316<P style="MARGIN-BOTTOM: 0cm">locations. These components should all be
317installed automatically once</P>
318<P style="MARGIN-BOTTOM: 0cm">you have configured the installation process by
319modifying the contents</P>
320<P style="MARGIN-BOTTOM: 0cm">of the "install.conf" file.</P>
321<P style="MARGIN-BOTTOM: 0cm"><BR></P>
322<P style="MARGIN-BOTTOM: 0cm">Please follow the instructions below to install
323the DX package(s):</P>
324<P style="MARGIN-BOTTOM: 0cm"><BR></P>
325<P style="MARGIN-BOTTOM: 0cm">1. Download the source (you'll have it if you are
326reading this).</P>
327<P style="MARGIN-BOTTOM: 0cm"><BR></P>
328<P style="MARGIN-BOTTOM: 0cm">2. Place the source file in a directory where you
329will control the</P>
330<P style="MARGIN-BOTTOM: 0cm">installation from, e.g. /usr/local/src.</P>
331<P style="MARGIN-BOTTOM: 0cm"><BR></P>
332<P style="MARGIN-BOTTOM: 0cm">3. Extract the contents of the tar file:</P>
333<P style="MARGIN-BOTTOM: 0cm"><BR></P>
334<P style="MARGIN-BOTTOM: 0cm">tar -xvf dx-${version}-all.tar</P>
335<P style="MARGIN-BOTTOM: 0cm">4. Then extract the parts you intend to build:</P>
336<P style="MARGIN-BOTTOM: 0cm"><BR></P>
337<P style="MARGIN-BOTTOM: 0cm">(i) Both server and client:</P>
338<P style="MARGIN-BOTTOM: 0cm">tar -xvzf pydxs-${version}.tar.gz</P>
339<P style="MARGIN-BOTTOM: 0cm">tar -xvzf pydxc-${version}.tar.gz </P>
340<P style="MARGIN-BOTTOM: 0cm"><BR></P>
341<P style="MARGIN-BOTTOM: 0cm">(ii) Server only:</P>
342<P style="MARGIN-BOTTOM: 0cm"><BR></P>
343<P style="MARGIN-BOTTOM: 0cm">tar -xvzf pydxs-${version}.tar.gz</P>
344<P style="MARGIN-BOTTOM: 0cm">(iii) Client only:</P>
345<P style="MARGIN-BOTTOM: 0cm">tar -xvzf pydxc-${version}.tar.gz</P>
346<P style="MARGIN-BOTTOM: 0cm"><BR></P>
347<P style="MARGIN-BOTTOM: 0cm">5. Copy the configuration file to a backup
348version:</P>
349<P style="MARGIN-BOTTOM: 0cm"><BR></P>
350<P style="MARGIN-BOTTOM: 0cm">cp install.conf install.conf.bak</P>
351<P style="MARGIN-BOTTOM: 0cm">6. Manually edit the "install.conf" configuration
352file using a standard editor. </P>
353<P style="MARGIN-BOTTOM: 0cm"><BR></P>
354<P style="MARGIN-BOTTOM: 0cm">7. Change directory to the appropriate
355sub-directory:</P>
356<P style="MARGIN-BOTTOM: 0cm"><BR></P>
357<P style="MARGIN-BOTTOM: 0cm">(i) Both server and client:</P>
358<P style="MARGIN-BOTTOM: 0cm">cd pydxs-${version}</P>
359<P style="MARGIN-BOTTOM: 0cm">(ii) Server only:</P>
360<P style="MARGIN-BOTTOM: 0cm">cd pydxs-${version}</P>
361<P style="MARGIN-BOTTOM: 0cm">(iii) Client only:</P>
362<P style="MARGIN-BOTTOM: 0cm">cd pydxc-${version}</P>
363<P style="MARGIN-BOTTOM: 0cm"><BR></P>
364<P style="MARGIN-BOTTOM: 0cm">8. Run the setup script in the directory you have
365entered:</P>
366<P style="MARGIN-BOTTOM: 0cm"><BR></P>
367<P style="MARGIN-BOTTOM: 0cm">&lt;your_python&gt;/python setup.py install</P>
368<P style="MARGIN-BOTTOM: 0cm">Where &lt;your_python&gt; is the path of the
369python version that CDAT is</P>
370<P style="MARGIN-BOTTOM: 0cm">installed under and the you want the DX package(s)
371to run under.</P>
372<P style="MARGIN-BOTTOM: 0cm">This script will prompt you to confirm that you
373want to create or</P>
374<P style="MARGIN-BOTTOM: 0cm">overwrite the directories you have specified.</P>
375<P style="MARGIN-BOTTOM: 0cm"><BR></P>
376<P style="MARGIN-BOTTOM: 0cm">Now, fingers crossed, you have successfully
377installed the Data</P>
378<P style="MARGIN-BOTTOM: 0cm">Extractor on your machine. </P>
379<P style="MARGIN-BOTTOM: 0cm"><BR></P>
380<P style="MARGIN-BOTTOM: 0cm">Testing your installation</P>
381<P style="MARGIN-BOTTOM: 0cm">========================= </P>
382<P style="MARGIN-BOTTOM: 0cm"><BR></P>
383<P style="MARGIN-BOTTOM: 0cm">If you have installed both the server and the
384client then you should</P>
385<P style="MARGIN-BOTTOM: 0cm">be able to view the CGI User Interface at the URL
386you provided in the</P>
387<P style="MARGIN-BOTTOM: 0cm">"install.conf" configuration file. Before you
388visit the URL you should</P>
389<P style="MARGIN-BOTTOM: 0cm">start the DX server's Web Service. This file is
390installed as the</P>
391<P style="MARGIN-BOTTOM: 0cm">python script:</P>
392<P style="MARGIN-BOTTOM: 0cm"><BR></P>
393<P style="MARGIN-BOTTOM: 0cm">dxs/bin/DXWSInterface.py</P>
394<P style="MARGIN-BOTTOM: 0cm"><BR></P>
395<P style="MARGIN-BOTTOM: 0cm">You would typically run this script in the
396background as it should run</P>
397<P style="MARGIN-BOTTOM: 0cm">continuously when you want the DX server to be
398available:</P>
399<P style="MARGIN-BOTTOM: 0cm"><BR></P>
400<P style="MARGIN-BOTTOM: 0cm">&lt;BASEDIR&gt;/dxs/bin/DXWSInterface.py &amp;</P>
401<P style="MARGIN-BOTTOM: 0cm"><BR></P>
402<P style="MARGIN-BOTTOM: 0cm">Once this is running you should open a browser and
403visit the URL of</P>
404<P style="MARGIN-BOTTOM: 0cm">your DX client User Interface (typically called
405"dxui"). If both</P>
406<P style="MARGIN-BOTTOM: 0cm">server and client are working then you should be
407able to select some</P>
408<P style="MARGIN-BOTTOM: 0cm">example data from the test datasets to demonstrate
409the workings of the</P>
410<P style="MARGIN-BOTTOM: 0cm">DX.</P>
411<P style="MARGIN-BOTTOM: 0cm"><BR></P>
412<P style="MARGIN-BOTTOM: 0cm">If you have any problems, suggestions or issues
413please contact Ag</P>
414<P style="MARGIN-BOTTOM: 0cm">Stephens
415&lt;a.stephens@rl.ac.uk&gt;.</P></BODY></HTML>