|
From: <ki...@us...> - 2003-04-24 19:12:39
|
Update of /cvsroot/pymerase/htdocs/docs/pymweb
In directory sc8-pr-cvs1:/tmp/cvs-serv14498
Added Files:
pymweb-install.html
Log Message:
The Pymweb Install docs v0.1.1
--- NEW FILE: pymweb-install.html ---
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">
<html>
<meta name="GENERATOR" content="TtH 3.33">
<style type="text/css"> div.p { margin-top: 7pt;}</style>
<style type="text/css"><!--
td div.comp { margin-top: -0.6ex; margin-bottom: -1ex;}
td div.comb { margin-top: -0.6ex; margin-bottom: -.6ex;}
td div.hrcomp { line-height: 0.9; margin-top: -0.8ex; margin-bottom: -1ex;}
td div.norm {line-height:normal;}
span.roman {font-family: serif; font-style: normal; font-weight: normal;}
span.overacc2 {position: relative; left: .8em; top: -1.2ex;}
span.overacc1 {position: relative; left: .6em; top: -1.2ex;} --></style>
<title> \cb Pymerase Docs - Pymweb Install</title>
<h1 align="center"><font color="#0000FF">Pymerase Docs - Pymweb Install</font> </h1>
<h3 align="center">Brandon King <br />
Copyright © 2003 California Institute of Technology </h3>
<h3 align="center">Version 0.1.1<br />Apr 24, 2003
</h3>
<div class="p"><!----></div>
<h1>Contents </h1><a href="#tth_sEc1"
>1 <font color="#0000FF">Notes</font></a><br />
<a href="#tth_sEc1.1"
>1.1 <font color="#0000FF">What is Pymweb?</font></a><br />
<a href="#tth_sEc1.2"
>1.2 <font color="#0000FF">What are the requirements for using Pymweb?</font></a><br />
<a href="#tth_sEc1.3"
>1.3 <font color="#0000FF">Changes Coming Soon</font></a><br />
<a href="#tth_sEc2"
>2 <font color="#0000FF">Installation</font></a><br />
<a href="#tth_sEc2.1"
>2.1 <font color="#0000FF">Download Pymweb</font></a><br />
<a href="#tth_sEc2.2"
>2.2 <font color="#0000FF">Edit Pymweb Apache Settings</font></a><br />
<a href="#tth_sEc2.2.1"
>2.2.1 <font color="#0000FF">Default Settings</font></a><br />
<a href="#tth_sEc2.2.2"
>2.2.2 <font color="#0000FF">Limit to localhost and specific subnet</font></a><br />
<a href="#tth_sEc2.2.3"
>2.2.3 <font color="#0000FF">Allow from all</font></a><br />
<a href="#tth_sEc2.3"
>2.3 <font color="#0000FF">Install</font></a><br />
<a href="#tth_sEc2.4"
>2.4 <font color="#0000FF">More Apache Configuration</font></a><br />
<a href="#tth_sEc3"
>3 <font color="#0000FF">Running Pymweb</font></a><br />
<a href="#tth_sEc3.1"
>3.1 <font color="#0000FF">Web Browser</font></a><br />
<a href="#tth_sEc3.2"
>3.2 <font color="#0000FF">Debuging</font></a><br />
<div class="p"><!----></div>
<div class="p"><!----></div>
<h2><a name="tth_sEc1">
1</a> <font color="#0000FF">Notes</font></h2>
<h3><a name="tth_sEc1.1">
1.1</a> <font color="#0000FF">What is Pymweb?</font></h3>
Pymweb is a web interface for running Pymerase<a href="#tthFtNtAAB" name="tthFrefAAB"><sup>1</sup></a> on the web.
<div class="p"><!----></div>
<h3><a name="tth_sEc1.2">
1.2</a> <font color="#0000FF">What are the requirements for using Pymweb?</font></h3>
<ul>
<li> Apache Web Server - http://www.apache.org/<br /><br /></li>
<li> Python2.2<br /><br /></li>
<li> Pymerase<br /><br /></li>
</ul>
<div class="p"><!----></div>
<h3><a name="tth_sEc1.3">
1.3</a> <font color="#0000FF">Changes Coming Soon</font></h3>
Please note that in the near future Pymerase will be undergoing a
major change to support XMI. A new parseXMI input module is almost
complete. When it's complete, Pymerase will no longer need to use
Jython. Pymweb currently hard codes information that Jython needs to
work properly... So, Pymweb will need to make some changes once Jython
is removed from the Pymerase dependancy list.
<div class="p"><!----></div>
<h2><a name="tth_sEc2">
2</a> <font color="#0000FF">Installation</font></h2>
<h3><a name="tth_sEc2.1">
2.1</a> <font color="#0000FF">Download Pymweb</font></h3>
Pymweb, currently, is only accessable via CVS on
sourceforge.net. Pymweb is found under the 'pymerase' CVS
module in director called 'pymweb'. Please visit the download section
of http://pymerase.sf.netfor more information on checking out CVS modules.
<div class="p"><!----></div>
<h3><a name="tth_sEc2.2">
2.2</a> <font color="#0000FF">Edit Pymweb Apache Settings</font></h3>
You will need to edit pymweb/conf/pymweb.conf so that Apache will know
who to give access to Pymweb. The default settings will limit access
to the machine in which it's running. If you wish to change the access
settings, below are some examples you can use.
<div class="p"><!----></div>
<h4><a name="tth_sEc2.2.1">
2.2.1</a> <font color="#0000FF">Default Settings</font></h4>
<pre>
Alias /pymweb /tmp/pymweb
<Location /pymweb>
order deny,allow
deny from all
allow from 127.0.0.0/255.0.0.0
Options Indexes MultiViews
</Location>
</pre>
<div class="p"><!----></div>
<h4><a name="tth_sEc2.2.2">
2.2.2</a> <font color="#0000FF">Limit to localhost and specific subnet</font></h4>
<pre>
Alias /pymweb /tmp/pymweb
<Location /pymweb>
order deny,allow
deny from all
allow from 127.0.0.0/255.0.0.0
allow from 192.168.1.0/255.255.255.0
Options Indexes MultiViews
</Location>
</pre>
<div class="p"><!----></div>
<h4><a name="tth_sEc2.2.3">
2.2.3</a> <font color="#0000FF">Allow from all</font></h4>
<pre>
Alias /pymweb /tmp/pymweb
<Location /pymweb>
order deny,allow
allow from all
Options Indexes MultiViews
</Location>
</pre>
<div class="p"><!----></div>
<h3><a name="tth_sEc2.3">
2.3</a> <font color="#0000FF">Install</font></h3>
In order to install Pymweb, especially with the default settings, you
will have to be running as root. Below is the command you would type
to install on a Debian system.
<pre>
python2.2 setup.py install
</pre>
Other flavors of linux will probably work as well, but you may want to
double check the default installation paths. The default install paths
are as follows:
<pre>
#Default (Debian) CGI installation path
CGI_PATH = '/usr/lib/cgi-bin/'
#Default (Debian) Apache WWW path
WWW_PATH = '/var/www/'
#Default (Debian) Apache Conf path
CONF_PATH = '/etc/apache/conf/'
</pre>
To override any of these paths, you can type the following command:
<pre>
python2.2 setup.py --cgiPath=/path/to/cgi/ --wwwPath=/path/to/www/ \
--confPath=/path/to/conf/ install
</pre>
<div class="p"><!----></div>
<h3><a name="tth_sEc2.4">
2.4</a> <font color="#0000FF">More Apache Configuration</font></h3>
You will need to add the following line to the end of your Apache
httpd.conf file located at /etc/apache/httpd.conf on Debian systems.
<div class="p"><!----></div>
<pre>
Include /etc/apache/conf/pymweb.conf
</pre>
<div class="p"><!----></div>
Once you have made the change, you will need to restart apache. You
can do so by running the following command on a Debian system:
<div class="p"><!----></div>
<pre>
/etc/init.d/apache restart
</pre>
<div class="p"><!----></div>
<h2><a name="tth_sEc3">
3</a> <font color="#0000FF">Running Pymweb</font></h2>
<h3><a name="tth_sEc3.1">
3.1</a> <font color="#0000FF">Web Browser</font></h3>
Once you have Pymweb installed, just point your web browser to the
machine in which you installed it on. In the case you installed it on
your local machine, you would type http://localhost/pymweb.html to
access the Pymweb form.
<div class="p"><!----></div>
<h3><a name="tth_sEc3.2">
3.2</a> <font color="#0000FF">Debuging</font></h3>
Pymweb, in it's current state, doesn't display very much debuging
information in the web browswer. If something doesn't work and you
want to know what, you can goto '/tmp/pymweb/@sessionNumber/' and
run the driver.sh script if one was generated for you. You may also
wish to look at the Apache error logs located at
'/var/log/apache/error.log'.
<div class="p"><!----></div>
Please e-mail pymerase-devel at lists.sourceforge.net if you have and
questions or need help debuging.
<div class="p"><!----></div>
<hr /><h3>Footnotes:</h3>
<div class="p"><!----></div>
<a name="tthFtNtAAB"></a><a href="#tthFrefAAB"><sup>1</sup></a>http://pymerase.sf.net
<br /><br /><hr /><small>File translated from
T<sub><font size="-1">E</font></sub>X
by <a href="http://hutchinson.belmont.ma.us/tth/">
T<sub><font size="-1">T</font></sub>H</a>,
version 3.33.<br />On 24 Apr 2003, 11:59.</small>
</html>
|