Diff for "HgWebDirStepByStepFtpOnly"

Differences between revisions 2 and 4 (spanning 2 versions)

This page describes how to setup the hgwebdir.cgi-skript on a (unix-)server to which you only have ftp-access. See also HgWebDirStepByStep.

Prequesites

FTP-access, Python, a cgi-bin directory, but Mercurial not installed on the server.

Consider using a webshell like http://phpshell.sourceforge.net/

How to do it

make a directory '/path/to/repos' to which the webserver may write
test whether its writeable
- by uploading test.sh
```
echo test > /path/to/repos/test
```
  to your cgi-bin/ and make it executable chmod a+x test.sh.
- open http://yourdomain/cgi-bin/test.sh, you'll get an server error, but that's okay
- now there should be a file /path/to/repos/test
- delete the file and test.sh
upload a recent version of Mercurical to the server (e.g. the whole /usr/local/lib/python2.4/site-packages/mercurial/) into /path/to/private_python_libs/mercurial. It must be compiled for the architecture of the server (you may try to [http://www.g-loaded.eu/2008/01/28/how-to-extract-rpm-or-deb-packages/ extract] precompiled version from Debian or a rpm).
make a new subdir cgi-bin/hg/

change hgwebdir.cgi locally to load Mercurial on the server:

# Uncomment to send python tracebacks to the browser if an error occurs:
import cgitb
cgitb.enable()

# adjust python path if not a system-wide install:
import sys
sys.path.insert(0, "/path/to/private_python_libs/") #note that this is one dir up from Mercurial

and upload it into cgi-bin/hg/. Make it executable.

make locally a hgweb.config:
```
[collections]
/path/to/repos/ = /path/to/repos/
```
and upload it to cgi-bin/hg/.
upload an existing repository myrep into /path/to/repos/myrep and make it writeable by the server.
you should now be able to access it at http://yourdomain/cgi-bin/hg/hgwebdir.cgi

probably you want to change /path/to/repos/myrep/.hg/hgrc to contain something like:

[web]
contact     = John Doe
description = This my rep
push_ssl = false
allow_archive = gz zip bz2
style = gitweb

#everybody may change it!
allow_push   = *

CategoryHowTo

-  ⇤ ← Revision 2 as of 2008-08-03 19:40:55 → 
  Size: 2075
  Editor: HenrykGerlach
  Comment: remark on server architecture
+   ← Revision 4 as of 2008-08-04 08:09:18 → ⇥
  Size: 2287
  Editor: HenrykGerlach
  Comment: enable cgitb; how to extract rpms
-Deletions are marked like this.
+Additions are marked like this.
 Line 5:
-FTP-access, Python, a cgi-bin directory, but mercurial not installed on the server.
+FTP-access, Python, a cgi-bin directory, but Mercurial not installed on the server.
 Line 21:
-. upload a recent version of mercurical to the server (e.g. the whole {{{/usr/local/lib/python2.4/site-packages/mercurial/}}})
 into {{{/path/to/private_python_libs/mercurial}}}. It must be compiled for the architecture of the server (you may try extract precompiled version from debian).
+. upload a recent version of Mercurical to the server (e.g. the whole {{{/usr/local/lib/python2.4/site-packages/mercurial/}}})
 into {{{/path/to/private_python_libs/mercurial}}}. It must be compiled for the architecture of the server (you may try to [http://www.g-loaded.eu/2008/01/28/how-to-extract-rpm-or-deb-packages/ extract] precompiled version from Debian or a rpm).
 Line 24:
-. change {{{hgwebdir.cgi}}} locally to load mercurial on the server:
+. change {{{hgwebdir.cgi}}} locally to load Mercurial on the server:
 Line 26:
+# Uncomment to send python tracebacks to the browser if an error occurs:
import cgitb
cgitb.enable()
-Line 28:
+Line 32:
-sys.path.insert(0, "/path/to/private_python_libs/") #note that this is one dir up from mercurial
+sys.path.insert(0, "/path/to/private_python_libs/") #note that this is one dir up from Mercurial
-Line 30:
+Line 34:
- and upload it into {{{cgi-bin/hg/}}}}. Make it executable.
+ and upload it into {{{cgi-bin/hg/}}}. Make it executable.
-Line 52:
+Line 56:
+----
CategoryHowTo