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> |