source: TI04-geosplat/trunk/gss/manuals/install.html @ 798

Subversion URL: http://proj.badc.rl.ac.uk/svn/ndg/TI04-geosplat/trunk/gss/manuals/install.html@798
Revision 798, 13.0 KB checked in by astephen, 14 years ago (diff)

Latest working version with install method.
Can accept more than one file but doesn't combine variables yet.

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="20060403;12421400">
9        <META NAME="ProgId" CONTENT="FrontPage.Editor.Document">
10</HEAD>
11<BODY LANG="en-US" DIR="LTR">
12<H1>The GeoSPlAT 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 GeoSpatial Plotting and Animation Tool (GeoSPlAT).
16Further information is, or soon will be, available in the following
17guides:</P>
18<UL>
19        <LI><P STYLE="margin-bottom: 0cm"><B>GeoSPlAT Overview</B></P>
20        <LI><P STYLE="margin-bottom: 0cm"><B>GeoSPlAT Administrator's Guide</B>
21                </P>
22        <LI><P STYLE="margin-bottom: 0cm"><B>GeoSPlAT User Guide</B> 
23        </P>
24        <LI><P><B>Guide to Securing GeoSPlAT</B> 
25        </P>
26</UL>
27<H2>Where to get the <B>GeoSPlAT</B> package</H2>
28<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">The
29<SPAN STYLE="font-weight: medium">GeoSPlAT</SPAN> package can be
30downloaded from the NERC DataGrid web site at:</SPAN></P>
31<P STYLE="margin-bottom: 0cm"><BR>
32</P>
33<P STYLE="margin-bottom: 0cm"><A HREF="http://ndg.nerc.ac.uk/geosplat"><SPAN STYLE="background: transparent">http://ndg.nerc.ac.uk/geosplat</SPAN></A></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 <SPAN STYLE="font-weight: medium">GeoSPlAT</SPAN>-Server
38and <SPAN STYLE="font-weight: medium">GeoSPlAT</SPAN>-Client
39packages. Typically you will install both of these but you may only
40install one if you intend to interact with another existing
41service/application.</SPAN></P>
42<H2>Setting up the <B><SPAN STYLE="background: transparent">GeoSPlAT</SPAN>-</B>Server</H2>
43<P STYLE="margin-bottom: 0cm">Below is a guide for installing and
44setting up the <SPAN STYLE="background: transparent"><SPAN STYLE="font-weight: medium">GeoSPlAT</SPAN></SPAN>-Server
45package on your local machine.</P>
46<H3>Requirements and dependencies</H3>
47<P STYLE="margin-bottom: 0cm">Y<SPAN STYLE="background: transparent">ou
48will need the following to run <SPAN STYLE="background: transparent"><SPAN STYLE="font-weight: medium">GeoSPlAT</SPAN></SPAN>-Server
49on your machine:</SPAN></P>
50<P STYLE="margin-bottom: 0cm"><BR>
51</P>
52<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>Operating
53System:</B> Unix/Linux (tested on RedHat 7.3 and SUSE 9.1).</SPAN></P>
54<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>Webserver:</B>
55Tested on Apache (comes as standard in Linux).</SPAN></P>
56<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>CDAT-4.0
57or greater: </B>Includes Python and VCS visualisation package.</SPAN></P>
58<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>ZSI
59SOAP Library Version 1.7 or greater:</B> Used to call and create Web
60Service SOAP interface.</SPAN></P>
61<P STYLE="margin-bottom: 0cm"><BR>
62</P>
63<H3 STYLE="margin-top: 0cm; margin-bottom: 0cm"><SPAN STYLE="background: transparent">Installing
64the external packages</SPAN></H3>
65<P STYLE="margin-bottom: 0cm"><BR>
66</P>
67<P STYLE="margin-bottom: 0cm"><B>Apache Web Server</B></P>
68<P STYLE="margin-bottom: 0cm; font-weight: medium">On many flavours
69of Unix/Linux an Apache web server will already be installed in which
70case it is normally just a case of starting it and finding out where
71the “htdocs” and “cgi-bin” directories are. On standard
72installs you might find these in one of following directories:</P>
73<P STYLE="margin-bottom: 0cm"><BR>
74</P>
75<P STYLE="margin-bottom: 0cm; font-weight: medium">/var/www/</P>
76<P STYLE="margin-bottom: 0cm; font-weight: medium">/srv/www/</P>
77<P STYLE="margin-bottom: 0cm"><BR>
78</P>
79<P STYLE="margin-bottom: 0cm; font-weight: medium">If you have to
80install apache yourself you'll need to collect the source code from:</P>
81<P STYLE="margin-bottom: 0cm"><BR>
82</P>
83<P STYLE="margin-bottom: 0cm"><A HREF="http://httpd.apache.org/download.cgi">http://httpd.apache.org/download.cgi</A></P>
84<P STYLE="margin-bottom: 0cm"><BR>
85</P>
86<P STYLE="margin-bottom: 0cm; font-weight: medium">Get the latest
87copy, I downloaded the file “httpd-2.2.0.tar.gz” to my /src/
88directory (but you can put it anywhere).</P>
89<P STYLE="margin-bottom: 0cm"><BR>
90</P>
91<P STYLE="margin-bottom: 0cm; font-weight: medium">Installing it was
92incredibly simple (these guys know what they are doing!)...the only
93thing you'll need to do is decide where to install your web server.</P>
94<P STYLE="margin-bottom: 0cm"><BR>
95</P>
96<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">gunzip
97httpd-2.2.0.tar.gz</FONT></P>
98<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">tar
99-xvf httpd-2.2.0.tar</FONT></P>
100<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">cd
101httpd-2.2.0</FONT></P>
102<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">mkdir
103&lt;MY_WEBSERVER_LOCATION&gt;</FONT></P>
104<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">./configure
105–prefix=&lt;MY_WEBSERVER_LOCATION&gt;</FONT></P>
106<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">make</FONT></P>
107<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">make
108install</FONT></P>
109<P STYLE="margin-bottom: 0cm"><BR>
110</P>
111<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Nimbus Roman No9 L">Then
112you can start the web server with:</FONT></P>
113<P STYLE="margin-bottom: 0cm"><BR>
114</P>
115<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">&lt;MY_WEBSERVER_LOCATION&gt;/bin/apachectl
116start</FONT></P>
117<P STYLE="margin-bottom: 0cm"><BR>
118</P>
119<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Nimbus Roman No9 L">You
120should then be able to view the top level web page via a browser at:</FONT></P>
121<P STYLE="margin-bottom: 0cm"><BR>
122</P>
123<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Nimbus Roman No9 L">http://&lt;YOUR_MACHINE_NAME&gt;/index.html</FONT></P>
124<P STYLE="margin-bottom: 0cm"><BR>
125</P>
126<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Nimbus Roman No9 L">If
127you cannot see this file then you may have a port error (e.g. if port
12880 is blocked on your system). You might be able to get around this
129by editing the “httpd.conf” configuration file at:</FONT></P>
130<P STYLE="margin-bottom: 0cm"><BR>
131</P>
132<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">&lt;MY_WEBSERVER_LOCATION&gt;/conf/httpd.conf</FONT></P>
133<P STYLE="margin-bottom: 0cm"><BR>
134</P>
135<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Nimbus Roman No9 L">In
136this file you can search for the word “Listen” and change the
137setting 80 to another number (I used 8080, not sure why). Once done
138your webserver top page will be visible at:</FONT></P>
139<P STYLE="margin-bottom: 0cm"><BR>
140</P>
141<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Nimbus Roman No9 L">http://&lt;YOUR_MACHINE_NAME&gt;:8080/index.html
142- where 8080 is the port you chose to listen on.</FONT></P>
143<P STYLE="margin-bottom: 0cm"><BR>
144</P>
145<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Nimbus Roman No9 L">In
146order to pick up this change you might have to stop and restart the
147server with:</FONT></P>
148<P STYLE="margin-bottom: 0cm"><BR>
149</P>
150<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">&lt;MY_WEBSERVER_LOCATION&gt;/bin/apachectl
151stop</FONT></P>
152<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">&lt;MY_WEBSERVER_LOCATION&gt;/bin/apachectl
153start</FONT></P>
154<P STYLE="margin-bottom: 0cm"><BR>
155</P>
156<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Nimbus Roman No9 L">This
157file should be located at:</FONT></P>
158<P STYLE="margin-bottom: 0cm"><BR>
159</P>
160<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">&lt;MY_WEBSERVER_LOCATION&gt;/htdocs/index.html</FONT></P>
161<P STYLE="margin-bottom: 0cm"><BR>
162</P>
163<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Nimbus Roman No9 L">The
164location of your “cgi-bin” directory should be:</FONT></P>
165<P STYLE="margin-bottom: 0cm"><BR>
166</P>
167<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Courier, monospace">&lt;MY_WEBSERVER_LOCATION&gt;/cgi-bin/</FONT></P>
168<P STYLE="margin-bottom: 0cm"><BR>
169</P>
170<P STYLE="margin-bottom: 0cm; font-weight: medium"><FONT FACE="Nimbus Roman No9 L">You
171should be able to write any cgi script and place it in the above
172directory with 755 permissions and will run.</FONT></P>
173<H3>NOTES TO INCLUDEs</H3>
174<P>plots not appearing unless you do 'canvas.open()' has just got me
175whilst installing a new version on redhat7.3 with cdat-4 (formerly it
176was still  talking to cdat-3.3). Strange!  -- MAKE THIS AN OPTION IN
177THE serverConfig.py file.</P>
178<H3><BR><BR>
179</H3>
180<H3><BR><BR>
181</H3>
182<H3>Contents of the <SPAN STYLE="background: transparent"><B>GeoSPlAT</B></SPAN>
183package</H3>
184<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">When
185you (g)unzip and decompress (tar -xvf) the downloaded file you will
186find the following directories:</SPAN></P>
187<P STYLE="margin-bottom: 0cm"><BR>
188</P>
189<OL>
190        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">dxs_source/for_cgi_bin/
191        - this directory contains the one python module that controls the
192        package and acts as a CGI script (normally splatui.py). This must be
193        installed within the webserver's CGI area (or any directory visible
194        via the web with read and execute permission for files).</SPAN></P>
195        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">dxs_source/for_local/
196        - this directory contains the actual DX-Server package itself and
197        can placed wherever you like (e.g. /usr/local/dxs/). These are all
198        the modules that define the routines and objects called by the <I>dxui</I>
199        CGI script. This directory also contain various sub-directories:</SPAN></P>
200</OL>
201<UL>
202        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">html/
203        - holds HTML page content for building a web interface.</SPAN></P>
204        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">doc/
205        - holds documentation for DX-Server.</SPAN></P>
206</UL>
207<OL START=3>
208        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">dxs_source/for_static_web/
209        - this directory contains the sub-directory dx_extra which in turn
210        holds the CSS style sheet for the web interface and the DX logo
211        under the logos directory.</SPAN></P>
212</OL>
213<P STYLE="margin-bottom: 0cm"><BR>
214</P>
215<H2>Setting up the DX-Server</H2>
216<P STYLE="margin-bottom: 0cm">Below is a guide for installing and
217setting up the DX-Server package on your local machine.</P>
218<H3>Requirements and dependencies</H3>
219<P STYLE="margin-bottom: 0cm">Y<SPAN STYLE="background: transparent">ou
220will need the following to run DX-Server on your machine:</SPAN></P>
221<P STYLE="margin-bottom: 0cm"><BR>
222</P>
223<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>Operating
224System:</B> Unix/Linux (tested on RedHat 7.3 and SUSE 9.1).</SPAN></P>
225<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent"><B>???Webserver:</B>
226Tested on Apache (comes as standard in Linux).</SPAN></P>
227<H3>Contents of the DX package</H3>
228<P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">When
229you (g)unzip and decompress (tar -xvf) the downloaded file you will
230find the following directories:</SPAN></P>
231<P STYLE="margin-bottom: 0cm"><BR>
232</P>
233<OL START=4>
234        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">dxs_source/for_cgi_bin/
235        - this directory contains the one python module that controls the
236        package and acts as a CGI script (normally splatui.py). This must be
237        installed within the webserver's CGI area (or any directory visible
238        via the web with read and execute permission for files).</SPAN></P>
239        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">dxs_source/for_local/
240        - this directory contains the actual DX-Server package itself and
241        can placed wherever you like (e.g. /usr/local/dxs/). These are all
242        the modules that define the routines and objects called by the <I>dxui</I>
243        CGI script. This directory also contain various sub-directories:</SPAN></P>
244</OL>
245<UL>
246        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">html/
247        - holds HTML page content for building a web interface.</SPAN></P>
248        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">doc/
249        - holds documentation for DX-Server.</SPAN></P>
250</UL>
251<OL START=3>
252        <LI><P STYLE="margin-bottom: 0cm"><SPAN STYLE="background: transparent">dxs_source/for_static_web/
253        - this directory contains the sub-directory dx_extra which in turn
254        holds the CSS style sheet for the web interface and the DX logo
255        under the logos directory.</SPAN></P>
256</OL>
257<P STYLE="margin-bottom: 0cm"><BR>
258</P>
259<H3>Trouble-shooting</H3>
260<P STYLE="margin-bottom: 0cm"><BR>
261</P>
262</BODY>
263</HTML>
Note: See TracBrowser for help on using the repository browser.