zuerst muss der Rechner mit fester IP konfiguriert werden.
Die DNS-Auflösung im Netz muss stimmen. Evt. muss der Rechner manuell auf dem DNS-Server eingetragen werden.
Die Uhrzeit muss per ntpd konfiguriert werden. siehe dazu ntp
Auf dem Rechner muss der Apache2 mit HTTPS installiert werden. siehe dazu Apache2
Die Softwarepakete mercurial, libapache2-mod-auth-pam, libapache2-mod-auth-sys-group müssen installiert werden:
apt-get install mercurial apache2 libapache2-mod-auth-pam libapache2-mod-auth-sys-group
Es muss ein Datenverzeichnis für Mercurial bestimmt werden (z.B. /daten/hg):
mkdir -p /daten/hg/meinCode
Jetzt wird ein Repository erstellt:
cd /daten/hg/meinCode ; hg init
Dem Apachebenutzer muss der Zugriff auf dieses Verzeichnis erlaubt werden.
chown -R www-data:www-data /daten/hg
jetzt wird eine Testdatei im repo erstellt:
echo "meine erste mercurialdatei" >blabla.txt
hg add blabla.txt
hg commit -Am "first commit" -u benutzername
Jetzt wird die Datei /etc/apache2/conf/hg.conf erstellt und dann wie folgt konfiguriert:
- hg.conf
##configdatei für mercurial / borwinius
ScriptAlias /hg/meinCode /usr/lib/cgi-bin/hgweb.cgi
<Directory /hg/meinCode>
AuthType Basic
AuthPAM_Enabled on
AuthName "Mercurial Repository meinCode erfordert eine Anmeldung"
AuthUserFile /dev/null
AuthPAM_FallThrough On
AuthBasicAuthoritative Off
AuthGroup_Enabled On
#Require valid-user
Require group meineNTGruppe
</Directory>
jetzt wird die Datei /usr/share/doc/mercurial/examples/hgweb.cgi in das normale cgi-bin-Verzeichnis kopiert.
cp /usr/share/doc/mercurial/examples/hgweb.cgi /usr/lib/cgi-bin/
Diese Datei (/usr/lib/cgi-bin/hgweb.cgi) wird jetzt wie folgt editiert:
- hgweb.cgi
#!/usr/bin/env python
#
# An example CGI script to use hgweb, edit as necessary
# adjust python path if not a system-wide install:
#import sys
#sys.path.insert(0, "/path/to/python/lib")
# enable importing on demand to reduce startup time
from mercurial import demandimport; demandimport.enable()
# Uncomment to send python tracebacks to the browser if an error occurs:
#import cgitb
#cgitb.enable()
# If you'd like to serve pages with UTF-8 instead of your default
# locale charset, you can do so by uncommenting the following lines.
# Note that this will cause your .hgrc files to be interpreted in
# UTF-8 and all your repo files to be displayed using UTF-8.
#
#import os
#os.environ["HGENCODING"] = "UTF-8"
from mercurial.hgweb.hgweb_mod import hgweb
import mercurial.hgweb.wsgicgi as wsgicgi
application = hgweb("/daten/hg/meinCode", "meinCode")
wsgicgi.launch(application)
Jetzt muss die Datei hgweb.cgi für den Apache ausführbar gemacht werden:
chmod 770 /usr/lib/cgi-bin/hgweb.cgi
Jetzt muss der Apachedienst neu gestartet werden:
/etc/init.d/apache2 restart
Jetzt kann schon von einem anderen mercurialclient das repo heruntergeladen werden:
hg clone https://meinhgserver/hg/meinCode meinCode
user: meinNTAccount
password: meinNTPasswort
Auf dem Client wurde jetzt das Verzeichnis „meinCode“ mit der Datei „blabla.txt“ erstellt.
Um auch Dateien oder Änderungen auf den Server hochladen (pushen) zu können,
muss die Datei /daten/hg/meinCode/.hg/hgrc erstellt und wie folgt konfiguriert werden:
- hgrc
[web]
allow_push = *
push_ssl = true
[paths]
default = /daten/hg/meinCode
Danach sollte der apache neu reloaded werden.
fertig.
Ein Repo hinter einem Proxyserver auschecken:
Bitte exportieren Sie die Umgebungsvariablen wie folgt:
export http-proxy-host = proxysrv:8080
export http-proxy-username = domaenenuser
export http-proxy-password = dasDomänenpasswort
anschließend versuchen Sie, das repo erneut auszuchecken:
hg clone http://meinentfernterServer/hg/meinCode meinCode
Lese- und Schreibzugriff auf ein Repository konfigurieren:
die Benutzer müssen sich zunächst einmal am Apache authentifiziert haben, danach werden zusätzliche Reporechte so vergeben:
die Datei im Repo .hg/hgrc
muss etwa wie folgt editiert werden:
...
[web]
allow_push = user1,user2
allow_read = user1,user2,user3,user4
#
#allow_pull funktionierte nicht bei mir
#analog gibt es auch noch:
#deny_push =
#deny_read =
...