[Moin-devel] CVS: dist CHANGES,1.75,1.76 INSTALL.html,1.3,1.4

Mon Mar 11 14:43:12 EST 2002

Update of /cvsroot/moin/dist
In directory usw-pr-cvs1:/tmp/cvs-serv22895

Modified Files:
	CHANGES INSTALL.html 
Log Message:
Release date added, got current install docs

Index: CHANGES
===================================================================
RCS file: /cvsroot/moin/dist/CHANGES,v
retrieving revision 1.75
retrieving revision 1.76
diff -C2 -r1.75 -r1.76
*** CHANGES	9 Mar 2002 15:55:22 -0000	1.75
--- CHANGES	11 Mar 2002 22:42:17 -0000	1.76
***************
*** 11,15 ****

  -----------------------------------------------------------------------------
! Version 0.11 (2002-01-xx, Revision 1.xxx)

  Most important new features: file attachments, definition list markup
--- 11,15 ----

  -----------------------------------------------------------------------------
! Version 0.11 (2002-03-11, Revision 1.151)

  Most important new features: file attachments, definition list markup
***************
*** 125,128 ****
--- 125,132 ----
      * navi_bar is now a list of page names which should be linked
        on every page
+     * test.cgi is now rolled into moin.cgi, and can be called
+       by adding "?test" to the wiki base URL. Also, as a security
+       feature, the server's environment is only shown for requests
+       local to the web server.

  Unfinished features:

Index: INSTALL.html
===================================================================
RCS file: /cvsroot/moin/dist/INSTALL.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -r1.3 -r1.4
*** INSTALL.html	6 Mar 2002 01:26:05 -0000	1.3
--- INSTALL.html	11 Mar 2002 22:42:18 -0000	1.4
***************
*** 2,6 ****
  <META HTTP-EQUIV="Content-Type" CONTENT="text/html;charset=iso-8859-1">
  <META NAME="MSSmartTagsPreventParsing" CONTENT="true">
! <META NAME="ROBOTS" CONTENT="NOINDEX,NOFOLLOW"><title>MoinMoin/InstallDocs - MoinMoin Wiki</title>
  <meta name="KEYWORDS" content="Moin, Moin/Install, Docs">
  <link rel="stylesheet" type="text/css" href="wiki/htdocs/css/moinmoin.css">
--- 2,6 ----
  <META HTTP-EQUIV="Content-Type" CONTENT="text/html;charset=iso-8859-1">
  <META NAME="MSSmartTagsPreventParsing" CONTENT="true">
! <META NAME="ROBOTS" CONTENT="NOINDEX,NOFOLLOW"><title>MoinMoin/InstallDocs - MoinMoin MASTER Wiki</title>
  <meta name="KEYWORDS" content="Moin, Moin/Install, Docs">
  <link rel="stylesheet" type="text/css" href="wiki/htdocs/css/moinmoin.css">
***************
*** 11,15 ****
  <link rel="Help" href="HelpOnFormatting">
  </head>
! <body onload="window.defaultStatus='MoinMoin Wiki'"><a name="top"></a>
  <h1>MoinMoin/InstallDocs</h1><hr>

--- 11,15 ----
  <link rel="Help" href="HelpOnFormatting">
  </head>
! <body onload="window.defaultStatus='MoinMoin MASTER Wiki'"><a name="top"></a>
  <h1>MoinMoin/InstallDocs</h1><hr>

***************
*** 192,196 ****
  <p>The first thing to do when your wiki does not work as expected is to issue the command "<tt class="wiki">tail /var/log/httpd/error_log</tt>" to display the most recent errors. Usually, you will get a hint on what went wrong, like missing file system permissions. 
  <p>The most common problem you might encounter is when you have Python 1.5.2 installed into "<tt class="wiki">/usr</tt>", and a newer Python distribution into "<tt class="wiki">/usr/local</tt>"; this is typical for GNU/Linux distributions that still come bundled with version 1.5.2 of Python. 
! <p>In that case, if you enter "<tt class="wiki">python</tt>" on you prompt, you will usually get the more recent Python interpreter, because "<tt class="wiki">/usr/local/bin</tt>" is in your <tt class="wiki">PATH</tt>. The situation is different in your webserver environment, and thus you might have to change the bang path of "<tt class="wiki">moin.cgi</tt>", like this: <pre class="code">
  #! /usr/local/bin/python 

--- 192,196 ----
  <p>The first thing to do when your wiki does not work as expected is to issue the command "<tt class="wiki">tail /var/log/httpd/error_log</tt>" to display the most recent errors. Usually, you will get a hint on what went wrong, like missing file system permissions. 
  <p>The most common problem you might encounter is when you have Python 1.5.2 installed into "<tt class="wiki">/usr</tt>", and a newer Python distribution into "<tt class="wiki">/usr/local</tt>"; this is typical for GNU/Linux distributions that still come bundled with version 1.5.2 of Python. 
! <p>In that case, if you enter "<tt class="wiki">python</tt>" on your prompt, you will usually get the more recent Python interpreter, because "<tt class="wiki">/usr/local/bin</tt>" is in your <tt class="wiki">PATH</tt>. The situation is different in your webserver environment, and thus you might have to change the bang path of "<tt class="wiki">moin.cgi</tt>", like this: <pre class="code">
  #! /usr/local/bin/python 

***************
*** 274,278 ****
  chmod a+rx *.cgi 
  </pre> </ul>
! <p>To be able to execute the CGI scripts in your home directory, you need to extend Python's path within those scripts, and possibly adapt the <em>bang path</em> (that is the first line of the script). So, change "<tt class="wiki">test.cgi</tt>" similarly to this diff: <ul>
  <p> <pre class="code">
  @@ -1,2 +1,2 @@ 
--- 274,278 ----
  chmod a+rx *.cgi 
  </pre> </ul>
! <p>To be able to execute the CGI script in your home directory, you need to extend Python's path within that script, and possibly adapt the <em>bang path</em> (that is the first line of the script). So, change "<tt class="wiki">moin.cgi</tt>" similarly to this diff: <ul>
  <p> <pre class="code">
  @@ -1,2 +1,2 @@ 
***************
*** 280,303 ****
  +#! /usr/local/bin/python2.1 

! @@ -12,2 +12,3 @@ 
!  import sys, cgi 
! +sys.path.extend(['/home/jh/wiki', '/home/jh/lib/python']) 
! </pre> </ul>
! <p>Finally, you can test your wiki installation by running the <em>MoinMoin CGI Diagnosis</em>: <ul>
! <p> <pre class="code">
! lynx -dump http://localhost/~jh/test.cgi 
! </pre> </ul>
! <p>If that test works, adapt your "<tt class="wiki">moin.cgi</tt>" just like you did for " <tt class="wiki">test.cgi</tt>": <ul>
! <p> <pre class="code">
! @@ -1,2 +1,2 @@ 
! -#! /usr/bin/env python 
! +#! /usr/local/bin/python2.1 
!  
! @@ -11,3 +11,4 @@ 

  -#import sys 
  +import sys 
  +sys.path.extend(['/home/jh/wiki', '/home/jh/lib/python']) 
!  #sys.path.append('/usr/local/home/USERNAME/lib/python') 
  </pre> </ul>
  <p>And now, your wiki should work and is available at the URL "<tt class="wiki">http://localhost/~jh/moin.cgi</tt>". Conclude your tests by editing and saving the <tt class="wiki">FrontPage</tt> and checking out <tt class="wiki">RecentChanges</tt>, which should reflect that edit.  
--- 280,294 ----
  +#! /usr/local/bin/python2.1 

! @@ -11,4 +11,4 @@ 

  -#import sys 
+ -#sys.path.append('/usr/local/home/USERNAME/lib/python') 
  +import sys 
  +sys.path.extend(['/home/jh/wiki', '/home/jh/lib/python']) 
!  
! </pre> </ul>
! <p>Finally, you can test your wiki installation by running the <em>MoinMoin CGI Diagnosis</em>: <ul>
! <p> <pre class="code">
! lynx -dump http://localhost/~jh/moin.cgi?test 
  </pre> </ul>
  <p>And now, your wiki should work and is available at the URL "<tt class="wiki">http://localhost/~jh/moin.cgi</tt>". Conclude your tests by editing and saving the <tt class="wiki">FrontPage</tt> and checking out <tt class="wiki">RecentChanges</tt>, which should reflect that edit.  
***************
*** 434,441 ****
  xcopy share\moin\data mywiki\data /E 
  copy share\moin\cgi-bin mywiki 
! copy share\moin\htdocs\index.html mywiki 
  </pre> 
  <p>"<tt class="wiki">mywiki</tt>" is the name of your wiki instance, you might want to chose a different name best fitting the intended use of this instance; just don't name it simply "<tt class="wiki">wiki</tt>", because that would result in problems later on. 
! <p>We have to make sure that <tt class="wiki">moin.cgi</tt> (and <tt class="wiki">test.cgi</tt> if you want to run it) can find the MoinMoin directory, so that "<tt class="wiki">import MoinMoin</tt>" will work. You can either setup a <tt class="wiki">PYTHONPATH</tt> environment variable which includes the installation path, but sometimes it can be tricky to make sure the variable will be set in the CGI environment. The easiest way to make sure <tt class="wiki">MoinMoin</tt> can be imported is to append to <tt class="wiki">sys.path</tt> <em>within</em> <tt class="wiki">moin.cgi</tt> and <tt class="wiki">test.cgi</tt>. 
  <p>You can change the first two lines of code in moin.cgi to something like this: 
  <pre class="code">
--- 425,432 ----
  xcopy share\moin\data mywiki\data /E 
  copy share\moin\cgi-bin mywiki 
! copy share\moin\htdocs\index.html mywiki\default.htm 
  </pre> 
  <p>"<tt class="wiki">mywiki</tt>" is the name of your wiki instance, you might want to chose a different name best fitting the intended use of this instance; just don't name it simply "<tt class="wiki">wiki</tt>", because that would result in problems later on. 
! <p>We have to make sure that <tt class="wiki">moin.cgi</tt> can find the MoinMoin directory, so that "<tt class="wiki">import MoinMoin</tt>" will work. You can either setup a <tt class="wiki">PYTHONPATH</tt> environment variable which includes the installation path, but sometimes it can be tricky to make sure the variable will be set in the CGI environment. The easiest way to make sure <tt class="wiki">MoinMoin</tt> can be imported is to append to <tt class="wiki">sys.path</tt> <em>within</em> <tt class="wiki">moin.cgi</tt>. 
  <p>You can change the first two lines of code in moin.cgi to something like this: 
  <pre class="code">
***************
*** 445,454 ****
  <p><img height="15" hspace="6" alt=" /!\ " src="wiki/htdocs/img/alert.gif" width="15"><b>Python 2.2</b>: Python 2.2 changed the installation layout. Because of this, you have to change the line of code given above to "<tt class="wiki">sys.path.append(r'C:\Moin\Lib\site-packages')</tt>".  </ul>
  <p>Next, you'll need to create two virtual directories in IIS. One for the shared data, and one for this specific wiki instance.  
! <p>Go to <em>Control Panel => Administrative Tools => Internet Information Service</em>. Open up the tree to <em>Default Web site</em>.  
  <p>Right click on <em>Default Web Site</em> and choose <em>New => Virtual directory</em>. This will bring up a wizard with the manditory useless first screen, hit next. Enter "<tt class="wiki">wiki</tt>" for the alias name and hit next. Browse to "<tt class="wiki">C:\Moin\share\moin\htdocs</tt>" and hit next. Leave the <em>Access permissions</em> at their defaults and hit next. And now you're done, hit finish! 
! <p>Now follow the same steps, but set the alias to "<tt class="wiki">mywiki</tt>" and the path to "<tt class="wiki">C:\Moin\mywiki</tt>".  <ul>
! <p> <img height="15" hspace="6" alt=" <!> " src="wiki/htdocs/img/attention.gif" width="15">TODO: <em>Does it need more permissions?</em> </ul>
! <p>Now you need to setup the 'mywiki' alias so that it will run Python to interpret <tt class="wiki">.cgi</tt> files. Right click on your new 'mywiki' alias and choose <em>Properties</em>. On the first tab (<em>Virtual Directory</em>), click the <em>Configuration</em> button. The first tab is the <em>App Mappings</em> tab, which defines which programs to use for each file exetension. Click <em>Add</em>. Browse to your <tt class="wiki">python.exe</tt> (probably something like <tt class="wiki">c:\pythonXX\python.exe</tt>). Then add <tt class="wiki">-u %s %s</tt> after the Python executable path. The <em>Executable</em> line will look something like this: <tt class="wiki">C:\Python22\python.exe -u %s %s</tt>. In the <em>Extension</em> box enter <tt class="wiki">.cgi</tt> with the begining period. Confirm that the <em>Check that file exists</em> option is not checked (if it is, MoinMoin won't be able to display sub pages). Ok, you're done with the alias configuration, click <em>OK</em> several times to get back out of all the dialog boxes. <ul>
! <p><img height="15" hspace="6" alt=" <!> " src="wiki/htdocs/img/attention.gif" width="15">TODO: Document directory permissions for IUSR_XXXX gotcha. </ul>
  <p>If you add another wiki instance, you'll only need to setup the reference to its folder, they can safely share the "<tt class="wiki">wiki</tt>" alias which points to static files only. 
  <p>That is all, try to access your new-born wiki with the URL "<tt class="wiki">http://127.0.0.1/mywiki/</tt>". You should see the FrontPage, try to edit and save it, and if that works, see if your edit is reflected on the RecentChanges page. 
--- 436,443 ----
  <p><img height="15" hspace="6" alt=" /!\ " src="wiki/htdocs/img/alert.gif" width="15"><b>Python 2.2</b>: Python 2.2 changed the installation layout. Because of this, you have to change the line of code given above to "<tt class="wiki">sys.path.append(r'C:\Moin\Lib\site-packages')</tt>".  </ul>
  <p>Next, you'll need to create two virtual directories in IIS. One for the shared data, and one for this specific wiki instance.  
! <p>Go to <em>Control Panel => Administrative Tools => Internet Information Service</em>. Open up the tree to <em>Default Web Site</em>.  
  <p>Right click on <em>Default Web Site</em> and choose <em>New => Virtual directory</em>. This will bring up a wizard with the manditory useless first screen, hit next. Enter "<tt class="wiki">wiki</tt>" for the alias name and hit next. Browse to "<tt class="wiki">C:\Moin\share\moin\htdocs</tt>" and hit next. Leave the <em>Access permissions</em> at their defaults and hit next. And now you're done, hit finish! 
! <p>Now follow the same steps, but set the alias to "<tt class="wiki">mywiki</tt>" and the path to "<tt class="wiki">C:\Moin\mywiki</tt>".  
! <p>Now you need to setup the 'mywiki' alias so that it will run Python to interpret <tt class="wiki">.cgi</tt> files. Right click on your new 'mywiki' alias and choose <em>Properties</em>. On the first tab (<em>Virtual Directory</em>), click the <em>Configuration</em> button. The first tab is the <em>App Mappings</em> tab, which defines which programs to use for each file exetension. Click <em>Add</em>. Browse to your <tt class="wiki">python.exe</tt> (probably something like <tt class="wiki">c:\pythonXX\python.exe</tt>). Then add <tt class="wiki">-u %s %s</tt> after the Python executable path. The <em>Executable</em> line will look something like this: <tt class="wiki">C:\Python22\python.exe -u %s %s</tt>. In the <em>Extension</em> box enter <tt class="wiki">.cgi</tt> with the begining period. Confirm that the <em>Check that file exists</em> option is not checked (if it is, MoinMoin won't be able to display sub pages). Ok, you're done with the alias configuration, click <em>OK</em> several times to get back out of all the dialog boxes. 
  <p>If you add another wiki instance, you'll only need to setup the reference to its folder, they can safely share the "<tt class="wiki">wiki</tt>" alias which points to static files only. 
  <p>That is all, try to access your new-born wiki with the URL "<tt class="wiki">http://127.0.0.1/mywiki/</tt>". You should see the FrontPage, try to edit and save it, and if that works, see if your edit is reflected on the RecentChanges page. 
***************
*** 463,466 ****
  <p><a name="head-285ec850c11d78bac10f6bfa31b69a37f1b257c9"></a><H2>Troubleshooting</H2>

! <p>If you see an error like "<tt class="wiki">ImportError: No module named MoinMoin</tt>", it means that python cannot find MoinMoin. See above for how to set your <tt class="wiki">PYTHONPATH</tt> or add to <tt class="wiki">sys.path</tt>.  <!-- MoinMoin 1.150 on zaibach served this page in 1.570 secs -->
  </body></html>
--- 452,455 ----
  <p><a name="head-285ec850c11d78bac10f6bfa31b69a37f1b257c9"></a><H2>Troubleshooting</H2>

! <p>If you see an error like "<tt class="wiki">ImportError: No module named MoinMoin</tt>", it means that python cannot find MoinMoin. See above for how to set your <tt class="wiki">PYTHONPATH</tt> or add to <tt class="wiki">sys.path</tt>.  
  </body></html>