Mercurial (hg) Installation Without Being Root: Unterschied zwischen den Versionen

Aus Open Source Ecology - Germany
Zur Navigation springen Zur Suche springen
 
(13 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
  
−
Solutions for installing mercurial from a package repository or via a self-extracting or any other installer for all operating system distribution can easily be found. So this is not the topic of thise Wiki entry. Here we cover the installation of a mercurial versioning system without root access. It is a necessary step for the creation of our synergetic hard and software development system that at a later point shall be mirrored by the Wiki to keep it up to date and to keep development efforts bundled in our versioning system (mercurial, git, svn, bzr, ...).
+
Solutions for installing mercurial from a package repository or via a self-extracting or any other installer can easily be found for all operating system distributions. Thus this is not the topic of this Wiki entry. Here we cover the installation of a mercurial versioning system '''without root access'''. It is a necessary step for the creation of our symbiotic open source hard and software development system that at a later point shall be mirrored by the Wiki to keep it up to date automatically and at all times. This allows us to bundle our efforts for development in our versioning system (I use mercurial, but git, svn, bzr, ... will be fine too).
 +
 
 +
In the following the process of how we got mercurial working on our webspace (we don't own a server due to financial reasons) is documented. A lot of special information is added in the second chapter that is nice to know, but as it turned out this did not work for us.
 +
 
 +
So the only really relevant part is the Chapter:  [[#Our_solution_.28what_we_ended_up_with.29:| Our solution (what finally worked for us)]]. If you want to know something about why the first undertakings did fail read all chapters, but I warn you, it's messy. Hence it's probably better to read the excerpt of [[#Problems_that_might_occur_.28and_occurred_for_me.29 | problems that occurred]] for us instead.
  
  
 
==With a Python installation readily available or with rights to install a python environment:==
 
==With a Python installation readily available or with rights to install a python environment:==
−
If a python installation is available or you have a server where you have adminsitrative rights for installing the python and still want to have a local installation of mercurial into your home directory, this also is no problem by using the Mercurial script: make install-home (to include documentation) or make install-home-bin (for the executable only). If you used a custom python location for the script it is required to add the following to the command to communicate it to hg:
+
It's also no problem, if a python installation is available or you have a server where you have adminsitrative rights (root access) for installing a python environment and still want to have a local installation of mercurial into your home directory. It is recomended to use the Mercurial script: ''make install-home'' (to include documentation) or ''make install-home-bin'' (for the executable only). If you used a custom python location for the script it is required to add the following to the command to communicate it to hg:
  
 
<code>
 
<code>
−
$ PYTHON=/path/to/python2.4-or-newer
+
$ PYTHON=/path/to/python2.7-or-newer #this will be supported for a long time
 
</code>
 
</code>
  
Zeile 15: Zeile 19:
  
 
Source: http://mercurial.selenic.com/wiki/UnixInstall#Per-user_installation
 
Source: http://mercurial.selenic.com/wiki/UnixInstall#Per-user_installation
 +
 +
Continue with Chapter: [[#Configure_Mercurial_for_a_Python_installation: | Configure Mercurial for a Python installation]].
  
  
Zeile 20: Zeile 26:
 
To install mercurial without being root, needs us to bundle Python 2.x (as Python 3 is not yet supported as there is only one advantage in favour of upgrading, so it's not worth the effort currently).
 
To install mercurial without being root, needs us to bundle Python 2.x (as Python 3 is not yet supported as there is only one advantage in favour of upgrading, so it's not worth the effort currently).
 
===Windows===
 
===Windows===
−
For Windows there currently is PortablePython as a ready made option.  
+
For Windows there currently is PortablePython as a ready made option. But you have to ensure that the header python-dev files are available. Otherwise it will not work. We have not tested this route as we consider Linux (Open source & non-profit, btw Mac OS is also essentially Linux, just like Android) our friend while Windows (Closed source & commercial) as our ... well, is enemy the correct word? I don't know.
 +
 
  
 
===UNIX/POSIX===
 
===UNIX/POSIX===
Zeile 32: Zeile 39:
  
 
<code>
 
<code>
−
cd $HOME    #cd ~ also works
+
$ cd $HOME    #cd ~ also works
 
</code>
 
</code>
  
  
 
<code>
 
<code>
−
sudo apt-get install python2.7 python2.7-dev #if unmet dependencies problem occurs see [http://wiki.opensourceecology.de/Mercurial_%28hg%29_Installation_Without_Being_Root#Problems_that_might_occur_.28and_occurred_for_me.29 below]
+
$ sudo apt-get install python2.7 python2.7-dev #if unmet dependencies problem occurs see [[#Problems_that_might_occur_.28and_occurred_for_me.29 | below]]
 
</code>
 
</code>
  
  
 
<code>
 
<code>
−
wget peak.telecommunity.com/dist/virtual-python.py    #if it can't be resolved, search the web for virtual-python.py .
+
$ wget peak.telecommunity.com/dist/virtual-python.py    #if it can't be resolved, search the web for virtual-python.py .
 
</code>
 
</code>
  
  
 
<code>
 
<code>
−
export PYTHONPATH=$HOME/python2.7/lib/python2.7/site-packages/     
+
$ export PYTHONPATH=$HOME/python2.7/lib/python2.7/site-packages/     
 
</code>
 
</code>
  
  
 
<code>
 
<code>
−
python2.7 </path/to/>virtual-python.py --prefix=$HOME/python2.7/    #Note: This in conjunction with the following command copies the python files to the specified path in the $HOME directory!
+
$ python2.7 </path/to/>virtual-python.py --prefix=$HOME/python2.7/    #Note: This in conjunction with the following command copies the python files to the specified path in the $HOME directory!
 
</code>
 
</code>
  
 
Because of <code>cd $HOME</code> in our case it becomes:
 
Because of <code>cd $HOME</code> in our case it becomes:
 
<code>
 
<code>
−
python2.7 ./virtual-python.py --prefix=$HOME/python2.7/
+
$ python2.7 ./virtual-python.py --prefix=$HOME/python2.7/
 
</code>
 
</code>
  
  
 
<code>
 
<code>
−
python2.7 ./virtual-python.py --prefix=$HOME/python2.7/
+
$ python2.7 ./virtual-python.py --prefix=$HOME/python2.7/
 
</code>
 
</code>
  
  
−
Two possibilities:
+
Two possibilities: Setuptools complete for creation of virtual python or - how we did it - only fetch the relevant part of setuptools package: (if another python version is required look [https://pypi.python.org/packages/2.7/s/setuptools/ here] for the .egg file):
−
 
 
−
1.  Fetch the relevant part of setuptools package: (if another python version is required look [https://pypi.python.org/packages/2.7/s/setuptools/ here] for the .egg file):
 
  
 
<code>
 
<code>
Zeile 79: Zeile 84:
  
 
<code>
 
<code>
−
chmod +x ./setuptools-0.6c11-py2.7.egg
+
$ chmod +x ./setuptools-0.6c11-py2.7.egg
 
</code>
 
</code>
  
  
−
Now make sure that the PYTHONPATH is pointing to the correct python directory: $HOME/python2.7/lib/python2.7/site-packages/ .
+
Now make sure that the PYTHONPATH is pointing to the correct python directory: <code>$HOME/python2.7/lib/python2.7/site-packages/</code> .
 
Check it using: <code>echo $PYTHONPATH</code> (If it's not correct, once again: <code>export PYTHONPATH=$HOME/python2.7/lib/python2.7/site-packages/</code>.
 
Check it using: <code>echo $PYTHONPATH</code> (If it's not correct, once again: <code>export PYTHONPATH=$HOME/python2.7/lib/python2.7/site-packages/</code>.
  
  
 
Then install easy_install binaries et alia using:
 
Then install easy_install binaries et alia using:
−
 
  
 
<code>
 
<code>
−
./setuptools-0.6c11-py2.7.egg --prefix=$HOME/python2.7/
+
$ ./setuptools-0.6c11-py2.7.egg --prefix=$HOME/python2.7/
 
</code>
 
</code>
  
Zeile 100: Zeile 104:
  
 
<!--
 
<!--
−
2. Use complete setuptools. Fetch setup tools sources:
+
2) Use complete setuptools. Fetch setup tools sources:
−
<code>
+
<code>$ wget https://bitbucket.org/pypa/setuptools/get/default.tar.gz#egg=setuptools-dev</code>
−
$ wget https://bitbucket.org/pypa/setuptools/get/default.tar.gz#egg=setuptools-dev
 
−
</code>
 
  
 
Unzip the downloaded package:
 
Unzip the downloaded package:
 +
<code>$ tar -xf pypa-setuptools<press Tab key for autocomplete or proposals></code>
 +
<code>$ cd <setuptools source directory></code>
 +
<code>$ $HOME/python2.7/bin/python ./setup.py install</code>
  
−
<code>
 
−
$ tar -xf pypa-setuptools<press Tab key for autocomplete or proposals>
 
−
</code>
 
−
 
−
 
−
<code>
 
−
$ cd <setuptools source directory></code>
 
−
 
−
 
−
<code>
 
−
$ $HOME/python2.7/bin/python ./setup.py install
 
−
</code>
 
 
http://stackoverflow.com/questions/11249901/creating-a-portable-python-local-install-for-linux
 
http://stackoverflow.com/questions/11249901/creating-a-portable-python-local-install-for-linux
 
-->
 
-->
Zeile 124: Zeile 117:
  
 
<code>
 
<code>
−
python2.7/bin/easy_install-2.7 --prefix=$HOME/python2.7/ mercurial
+
$ python2.7/bin/easy_install-2.7 --prefix=$HOME/python2.7/ mercurial
 
</code>
 
</code>
  
Zeile 131: Zeile 124:
  
 
<code>
 
<code>
−
find python2.7 -type d | xargs chmod a+rx  
+
$ find python2.7 -type d | xargs chmod a+rx  
 
</code>
 
</code>
  
Zeile 139: Zeile 132:
  
 
<code>
 
<code>
−
find python2.7 -type f | xargs chmod a+r  
+
$ find python2.7 -type f | xargs chmod a+r  
 
</code>
 
</code>
  
  
−
===Avoid this: Bundle Mercurial and Python===
+
====Avoid this: Bundle Mercurial and Python====
 
This is only required if no compiler on target host/server and if using make install-home-bin is impossible and all other <code>make install</code> fail.
 
This is only required if no compiler on target host/server and if using make install-home-bin is impossible and all other <code>make install</code> fail.
  
 
<code>
 
<code>
−
tar -cvzhf mercurial.tar.gz python2.7/    #compress, verbose, z: use gzip2, h: dump files that symbolic links point to instead of using the symbolic link, files, -C or --directory <target_directory>; if you have compatibility issues omit the '-' after the tar or use another archiver like 'pax' which is standard-compliant. tar might well come from times where dinosaurs were around. ; )
+
$ tar -cvzhf mercurial.tar.gz python2.7/    #compress, verbose, z: use gzip2, h: dump files that symbolic links point to instead of using the symbolic link, files, -C or --directory <target_directory>; if you have compatibility issues omit the '-' after the tar or use another archiver like 'pax' which is standard-compliant. tar might well come from times where dinosaurs were around. ; )
 
</code>
 
</code>
  
Zeile 153: Zeile 146:
 
Remove no longer needed temporary files if desired:
 
Remove no longer needed temporary files if desired:
 
<code>
 
<code>
−
rm -rf python2.7 setuptools-0.6c11-py2.7.egg virtual-python.py    #f: force : ignore non-existant files, never prompt. (so non-interruptable)
+
$ rm -rf python2.7 setuptools-0.6c11-py2.7.egg virtual-python.py    #f: force : ignore non-existant files, never prompt. (so non-interruptable)
 
</code>
 
</code>
  
Zeile 160: Zeile 153:
  
  
−
<code>mkdir mercurial_python_creation/ && mv mercurial.* mercurial_python_creation/ && mv virtual_python.py mercurial_python_creation/ && mv python2* mercurial_python_creation/</code>
+
<code>$ mkdir mercurial_python_creation/ && mv mercurial.* mercurial_python_creation/ && mv virtual_python.py mercurial_python_creation/ && mv python2* mercurial_python_creation/</code>
  
  
Zeile 168: Zeile 161:
  
  
−
<code>scp ~/mercurial.tar.gz <user>@<server>:mercurial.tar.gz</code>
+
<code>$ scp ~/mercurial.tar.gz <user>@<server>:mercurial.tar.gz</code>
  
  
Zeile 177: Zeile 170:
  
 
<code>
 
<code>
−
ssh <user>@<server>
+
$ ssh <user>@<server>
 
</code>
 
</code>
  
Zeile 186: Zeile 179:
  
 
<code>
 
<code>
−
cd $HOME && tar -xzf mercurial.tar.gz    #attention the resulting folder is python<version> in place of mercurial
+
$ cd $HOME && tar -xzf mercurial.tar.gz    #attention the resulting folder is python<version> in place of mercurial
 
</code>
 
</code>
  
Zeile 195: Zeile 188:
  
 
<code>
 
<code>
−
ls -a mercurial/bin/    # -a for all files (including hidden ones)
+
$ ls -a mercurial/bin/    # -a for all files (including hidden ones)
 
</code>
 
</code>
−
 
−
 
  
 
<code>
 
<code>
Zeile 205: Zeile 196:
  
  
 +
Create wrapper shell script: Insert lines:
  
 +
<code>#!/bin/sh</code>
  
−
Create wrapper shell script: Insert lines:
+
<code>
−
1. <code>
 
−
#!/bin/sh
 
−
</code>
 
−
2. <code>
 
 
export PYTHONPATH=$(HOME)/python-dev/lib/python2.7/site-packages
 
export PYTHONPATH=$(HOME)/python-dev/lib/python2.7/site-packages
 
</code>
 
</code>
−
3. <code>
+
 
 +
<code>
 
$(HOME)/python-dev/bin/hg "$@"
 
$(HOME)/python-dev/bin/hg "$@"
 
</code>
 
</code>
Zeile 225: Zeile 215:
  
  
−
==Configure Mercurial for a Python installation or PortablePython:==
+
==Configure Mercurial for a Python installation:==
  
 
<code>
 
<code>
Zeile 232: Zeile 222:
  
 
<code>
 
<code>
−
$ scp ~/mercurial-2.8.tar.gz ftp118002-2629078@dragontale.de:mercurial-2.8.tar.gz
+
$ scp ~/mercurial-2.8.tar.gz <user>@<server>:mercurial-2.8.tar.gz
 
</code>
 
</code>
  
Zeile 238: Zeile 228:
  
 
Extracting into a folder requires this folder to already exist! (so then don't omit this step). We chose 'mercurial' as the target directory:
 
Extracting into a folder requires this folder to already exist! (so then don't omit this step). We chose 'mercurial' as the target directory:
−
 
−
 
  
 
<code>
 
<code>
−
mkdir mercurial    #alternatively call it 'hg'
+
$ mkdir mercurial    #alternatively call it 'hg'
 
</code>
 
</code>
  
  
 
Unpack the downloaded mercurial package:
 
Unpack the downloaded mercurial package:
−
 
  
 
<code>
 
<code>
 
$ tar -xzf mercurial-2.8.tar.gz --directory mercurial    # -C is a synonym=alias for --directory
 
$ tar -xzf mercurial-2.8.tar.gz --directory mercurial    # -C is a synonym=alias for --directory
 
</code>
 
</code>
−
 
  
 
<code>
 
<code>
Zeile 260: Zeile 246:
  
 
now
 
now
 +
 
'''EITHER'''
 
'''EITHER'''
−
 
  
 
<code>
 
<code>
 
$ make PYTHON=$HOME/python2.7/bin/python PREFIX=/usr/local/ install-home-bin
 
$ make PYTHON=$HOME/python2.7/bin/python PREFIX=/usr/local/ install-home-bin
 
</code>
 
</code>
−
 
  
 
<code>
 
<code>
Zeile 272: Zeile 257:
 
</code>
 
</code>
  
−
 
+
'''OR'''
−
'''OR
 
−
'''
 
  
 
<code>
 
<code>
 
$ make PYTHON=$HOME/python2.7/bin/python local    # build for inplace usage (only within current folder) and only if a compiler is available.
 
$ make PYTHON=$HOME/python2.7/bin/python local    # build for inplace usage (only within current folder) and only if a compiler is available.
 
</code>
 
</code>
−
 
  
 
<code>
 
<code>
 
$ ./hg --version  # should show the latest version
 
$ ./hg --version  # should show the latest version
 
</code>
 
</code>
 +
 +
 +
Now continue with Sub-Chapter: [[#Resume_Mercurial_installation. | Make Python and Mercurial commands available (ease of use)]].
  
  
Zeile 307: Zeile 292:
  
 
<code>
 
<code>
−
sudo apt-get source mercurial    #called from $HOME
+
$ sudo apt-get source mercurial    #called from $HOME
 
</code>
 
</code>
  
 
This made me feel strange once again, but at least this resolved the python issues.
 
This made me feel strange once again, but at least this resolved the python issues.
−
 
  
 
The next problem was a old the python header files were missing once again. So that is a strong indicator of missing installation of python<version>-dev package on the target system (server in our case).
 
The next problem was a old the python header files were missing once again. So that is a strong indicator of missing installation of python<version>-dev package on the target system (server in our case).
Zeile 324: Zeile 308:
  
  
−
==Working solution==
 
  
 +
<!-- WORKING SOLUTION -->
 +
==Our solution (what we ended up with):==
  
−
As more and more problems occurred, I decided to split up the problems. So now all efforts went into installing Python into a home directory and that works fluently, but the question was if all libraries were available. And they weren't.
 
  
−
With root access this all had not been any problem as the root problem were missing python-dev header files. Now we had to compile our own python in the $HOME directory.
+
As more and more problems occurred, I decided to split up the problem. So now all efforts went into first installing Python into a home directory and that works quite fluently, but the question was if all libraries were available - And they weren't! :/
  
−
Trying to install mercurial complained once more about missing bz2 which it needs to compress files for versioning.
+
With root access this all had not been problematic as the root problem were missing python-dev header files. So we had to grab the problem at its root and hence compiled our own python into our target <code>$HOME</code> directory.
  
−
Of course the obvious solution is to fetch the sources for libbz2 but that leavest us with several other error messages if we forget to copy the library (.so) file to $HOME/lib/ directory. For buliding a library .so file we also need yet another trick: using the alternative Makefile. So here go all the commands that finally succeeded:
+
This resolved the header problems. But when trying to install mercurial it complained once more - this time about missing bz2 which mercurial needs to compress files for versioning.
  
−
On the local machine that has to be almost identical to the remote target:
+
Of course the obvious solution is to fetch the sources for libbz2 but that left us with several other error messages as it is easily forgotten to copy the library (.so) file to <code>$HOME/lib/</code> directory. For buliding a library .so file we also need yet another trick: using the alternative Makefile. So here go all the commands that finally succeeded:
  
 +
 +
On the local machine - that has to be almost identical to the remote target - issue the the following commands:
  
 
<code>
 
<code>
 
$ cd $HOME && sudo apt-get install python2.7 python2.7-dev && sudo apt-get source python2.7 python2.7-dev
 
$ cd $HOME && sudo apt-get install python2.7 python2.7-dev && sudo apt-get source python2.7 python2.7-dev
 
</code>
 
</code>
−
 
  
 
<code>
 
<code>
 
$ scp $HOME/python2*.t* <user>@<target_remote>:    #it's essentially a wget <python-dev-sources>
 
$ scp $HOME/python2*.t* <user>@<target_remote>:    #it's essentially a wget <python-dev-sources>
 
</code>
 
</code>
 +
 +
 +
===Fetch sources for Mercurial.===
  
 
Change to the remote machine via ssh <code><user>@<target_remote></code> and enter:
 
Change to the remote machine via ssh <code><user>@<target_remote></code> and enter:
Zeile 357: Zeile 345:
  
 
<code>
 
<code>
−
$ tar -xf mercurial-2.8.tar.gz && mv mercurial-2.8 mercurial    #if no error message is shown, everything went fine
+
$ tar -xf mercurial-2.8.tar.gz && mv mercurial-2.8 mercurial    #if no error message is shown, everything went fine, omit the last command if desired.
 
</code>
 
</code>
 +
 +
 +
 +
===Fetch missing library sources===
  
 
<code>
 
<code>
Zeile 366: Zeile 358:
  
 
Don't forget to overwrite the PREFIX otherwise it will point to /usr/local and there we don't have access to! So:
 
Don't forget to overwrite the PREFIX otherwise it will point to /usr/local and there we don't have access to! So:
 +
 
<code>
 
<code>
 
$ export PYTHONPATH=$HOME/lib/python2.7/dist-packages/ && export PREFIX=$HOME
 
$ export PYTHONPATH=$HOME/lib/python2.7/dist-packages/ && export PREFIX=$HOME
 
</code>
 
</code>
−
 
  
 
<code>
 
<code>
 
$ make -f Makefile-libbz2_so    # build the library
 
$ make -f Makefile-libbz2_so    # build the library
 
</code>
 
</code>
−
 
  
 
<code>
 
<code>
 
$ make    # build the library
 
$ make    # build the library
 
</code>
 
</code>
−
 
  
 
<code>
 
<code>
 
$ make PREFIX=$HOME install
 
$ make PREFIX=$HOME install
 
</code>
 
</code>
−
 
  
 
<code>
 
<code>
Zeile 394: Zeile 383:
 
</code>
 
</code>
  
−
Continue the Python installation: If you did not go the scp route as shown at the beginning of this chapter, then make sure you get the python<version>-dev packages! Otherwise header files will be missing.
+
 
 +
 
 +
===Resume the Python installation:===
 +
 
 +
If you did not go the scp route as shown at the beginning of this chapter, then make sure you get the python<version>-dev packages! Otherwise header files will be missing.
 
<!-- wget http://www.python.org/ftp/python/2.7.3/Python-2.7.3.tar.bz2 # not enough!! we need the header files (-dev) too! -->
 
<!-- wget http://www.python.org/ftp/python/2.7.3/Python-2.7.3.tar.bz2 # not enough!! we need the header files (-dev) too! -->
 
<code>
 
<code>
 
$ cd ~ && tar -xf <python-dev>.tar.gz  && mv <python-dev> python-dev && cd python-dev
 
$ cd ~ && tar -xf <python-dev>.tar.gz  && mv <python-dev> python-dev && cd python-dev
 
</code>
 
</code>
 +
  
 
Now we have  'mercurial' and 'python-dev' directories and have changed our pwd (parent working directory) to the latter.
 
Now we have  'mercurial' and 'python-dev' directories and have changed our pwd (parent working directory) to the latter.
Zeile 411: Zeile 405:
 
</code>
 
</code>
  
−
No if we want to install mercurial, it will complain about missing docutils. So let's adapt another trick and install 'docutils' using 'easy_install', hence using setuptools:
+
Now if we try to install mercurial, it might complain about missing docutils. So let's adapt another trick and install 'docutils' using 'easy_install', hence using setuptools.
 +
 
 +
 
 +
 
 +
===Setuptools - Install docutils. ===
  
 
Fetch the relevant part of setuptools package: (if another python version is required look [https://pypi.python.org/packages/2.7/s/setuptools/ here] for the .egg file):
 
Fetch the relevant part of setuptools package: (if another python version is required look [https://pypi.python.org/packages/2.7/s/setuptools/ here] for the .egg file):
Zeile 421: Zeile 419:
 
I figured that this command was missing to make sure we get a successful install:
 
I figured that this command was missing to make sure we get a successful install:
 
<code>
 
<code>
−
chmod +x ./setuptools-0.6c11-py2.7.egg    # make it executable
+
$ chmod +x ./setuptools-0.6c11-py2.7.egg    # make it executable
 
</code>
 
</code>
 
Now make sure that the PYTHONPATH is pointing to the correct python directory: $HOME/python2.7/lib/python2.7/site-packages/ .
 
Now make sure that the PYTHONPATH is pointing to the correct python directory: $HOME/python2.7/lib/python2.7/site-packages/ .
Zeile 436: Zeile 434:
 
$ ~/bin/easy_install docutils
 
$ ~/bin/easy_install docutils
 
</code>
 
</code>
 +
 +
 +
 +
===Finish python installation===
  
 
<code>
 
<code>
 
$ cd ~/python-dev/ && make altinstall prefix=$HOME exec-prefix=$HOME
 
$ cd ~/python-dev/ && make altinstall prefix=$HOME exec-prefix=$HOME
 
</code>
 
</code>
 +
 +
<code>
 +
$ ln -s ~/bin/python2.7 ~/bin/python    # if python not already exists we add it as a symbolic link
 +
</code>
 +
 +
 +
 +
===Resume Mercurial installation.===
  
 
Install mercurial and test it: If basic command list is shown, that'd be brilliant.
 
Install mercurial and test it: If basic command list is shown, that'd be brilliant.
  
 
<code>
 
<code>
−
cd <mercurial-sources-dir> && make PYTHON=$HOME/bin/python install-home-bin &&  ~/bin/hg
+
$ cd <mercurial-sources-dir> && make PYTHON=$HOME/bin/python install-home-bin &&  ~/bin/hg
 
</code>
 
</code>
  
 +
 +
 +
===Make python and hg commands available:===
 +
 +
As the target server probably does have another installation of python in /usr/bin we want to overwrite the python command to automatically use the correct one [the one we installed ourselves]. So we append an alias to the .bashrc and .bash_profile that should get executed on ssh login too. Also we make the hg command available in our <code>$HOME</code> directory and all directories below included.
 +
 +
====If .bashrc and .bash_profile not exist, create them:====
 +
If the files .bashrc and .bash_profile don't exist yet in <code>$HOME</code> directory - check it via <code>ls -a $HOME</code> - then use <code>vi ~/.bashrc</code> and type 'i' key for insert mode and insert <code>#!/bin/sh</code>. Then leave the Insert mode via <code>ESC</code> and save the file by typing <code>:wq</code>.
 +
 +
As an alternative:
 +
 +
<code>$ touch ~/.bashrc && echo "#!/bin/sh" >> ~/.bashrc</code>
 +
 +
 +
<code>$ touch ~/.bash_profile && echo "#!/bin/sh" >> ~/.bash_profile</code>
 +
 +
 +
 +
====Create alias:====
 
<code>
 
<code>
−
$ ln -s ~/bin/python2.7 ~/bin/python
+
$ echo "alias python='~/bin/python'" >> ~/.bashrc && echo "alias python='~/bin/python'" >> ~/.bash_profile && echo "alias hg='~/bin/hg'" >> ~/.bashrc && echo "alias hg='~/bin/hg'" >> ~/.bash_profile
 
</code>
 
</code>
  
 +
The <code>.hgrc</code> file it used for defining exceptions and other settings. See this splendid [url=http://cgcookie.com/blender/2013/08/20/using-mercurial-version-control-with-blender-projects/]blender instructional mercurial video[/url] of Sebastian König.
 +
 +
<code>$ '#mercurial setup\r\nexport HGRCPATH=$(HOME)/.hgrc' >> ~/.bash_profile && source ~/.bash_profile</code>
  
−
As the target server probably does have another installation of python in /usr/bin we want to overwrite the python command to automatically use the correct one [the one we installed ourselves]. So we append an alias to the .bashrc and .bash_profile that should get executed on ssh login too. Also we make the hg command available in our $HOME directory and all directories below included.
 
  
−
If the files .bashrc and .bash_profile don't exist yet in $HOME directory - check it via <code>ls -a $HOME</code> - then use <code>vi ~/.bashrc</code> and type 'i' key for insert mode and insert <code>#!/bin/sh</code>. Then leave the Insert mode via <code>ESC</code> and save the file by typing <code>:wq</code>.
 
  
  
−
<code>
+
===Done - Follow the mercurial introduction.===
−
'alias python=\'~/bin/python\'' >> ~/.bashrc
+
 
−
&& 'alias python=\'~/bin/python\'' >> ~/.bash_profile
+
Now follow the blender example tutorial a bit. You can omit the blender file manipulation and you will still learn a lot by simply following along and creating your own repository out of any files. Or you just start by navigating to your project folder via <code>$ cd $HOME/<project_folder_within_home_including_below></code> and typing <code>$ hg init</code> and then hg for getting help or just <code>$ hg add *</code> to add files and <code>hg commit</code> for your first commit to check in where you start. Once you have changed something substantially and think it's required to go back to this version - e.g. because it's working and you plan a bigger change that probably breaks things - then just <code>$ hg commit</code> from within the project directory. Now have fun. : -)
−
&& 'alias hg=\'~/bin/hg\'' >> ~/.bashrc
+
 
−
&& 'alias hg=\'~/bin/hg\'' >> ~/.bash_profile
+
 
−
</code>
+
<!-- WORKING SOLUTION -END -->
  
−
.hgrc file it used for defining exceptions and other settings. See this splendid [url=http://cgcookie.com/blender/2013/08/20/using-mercurial-version-control-with-blender-projects/]blender instructional mercurial video[/url] of Sebastian König.
 
  
−
<code>'#mercurial setup\r\nexport HGRCPATH=$(HOME)/.hgrc' >> ~/.bash_profile && source ~/.bash_profile</code>
 
  
  
−
Now follow the blender example tutorial a bit. You can omit the blender file manipulation and you will still learn a lot by simply following along and creating your own repository out of any files. Or you just start by navigating to your project folder via <code>$ cd $HOME/<project_folder_within_home_including_below> and typing <code>$ hg init</code> and then hg for getting help or just <code>hg add *</code> to add files and <code>hg commit</code> for your first commit to check in where you start. Once you have changed something substantially and think it's required to go back to this version - e.g. because it's working and you plan a bigger change that probably breaks things - then just <code>$ hg commit</code> from within the project directory. Now have fun. : -)
 
  
 
<!--HG WEB we don't need as our goal is to simply mirror the files of a versioned Project directory (created via <code>hg init</code>) to a Webpage which itself might partly be mirrored by a Wiki.
 
<!--HG WEB we don't need as our goal is to simply mirror the files of a versioned Project directory (created via <code>hg init</code>) to a Webpage which itself might partly be mirrored by a Wiki.
Zeile 482: Zeile 509:
  
 
<code>
 
<code>
−
vi /hg/hgweb.config    # start insert mode by typing 'i'
+
$ vi /hg/hgweb.config    # start insert mode by typing 'i'
 
</code>
 
</code>
  
Zeile 507: Zeile 534:
  
 
<!--
 
<!--
 +
<code>
 
mkdir source
 
mkdir source
−
wget http://mercurial.selenic.com/release/mercurial-1.8.2.tar.gz
+
wget http://mercurial.selenic.com/release/mercurial-1.8.2.tar.gz</code>
  
 
**I have a custom compiled Python 2.6 that somehow did not have bz2 package, these steps installs them**
 
**I have a custom compiled Python 2.6 that somehow did not have bz2 package, these steps installs them**
−
 
+
<code>
 
wget http://www.bzip.org/1.0.5/bzip2-1.0.5.tar.gz
 
wget http://www.bzip.org/1.0.5/bzip2-1.0.5.tar.gz
 
tar xzf ..
 
tar xzf ..
Zeile 524: Zeile 552:
 
./configure –prefix=$HOME
 
./configure –prefix=$HOME
 
make
 
make
 +
</code>
 
[We should not see bz2 on the not built module list now]
 
[We should not see bz2 on the not built module list now]
 +
 +
<code>
 
make install
 
make install
 +
</code>
  
 
[Now test the python still works:]
 
[Now test the python still works:]
−
which python (confirm its the one we have in our own bin)
+
<code>which python (confirm its the one we have in our own bin)
−
python (see it actually works…)
+
python (see it actually works…)</code>
 
[Now test the python still works:]
 
[Now test the python still works:]
  
 
**I have a custom compiled Python 2.6 that somehow did not have bz2 package, these steps installs them**
 
**I have a custom compiled Python 2.6 that somehow did not have bz2 package, these steps installs them**
 
[So we are back in mercurial]
 
[So we are back in mercurial]
−
 
+
<code>
−
make all
+
make all</code>
  
 
**It now complains about missing docutils, this this happens, follow the steps below, this assumes your custom Python has setuptools**
 
**It now complains about missing docutils, this this happens, follow the steps below, this assumes your custom Python has setuptools**
−
 
+
<code>easy_install docutils</code>
−
easy_install docutils
 
  
 
**It now complains about missing docutils, this this happens, follow the steps below, this assumes your custom Python has setuptools**
 
**It now complains about missing docutils, this this happens, follow the steps below, this assumes your custom Python has setuptools**
−
 
+
<code>
 
vi ~/.bash_profile
 
vi ~/.bash_profile
 
export HGRCPATH=[HOME]/.hgrc
 
export HGRCPATH=[HOME]/.hgrc
 
source ~/.bash_profile
 
source ~/.bash_profile
−
hg –version
+
hg –version</code>
  
 
Now we have Mercurial installed. We can configure repos:
 
Now we have Mercurial installed. We can configure repos:
−
 
+
<code>
 
mkdir -p ~/hg/repos
 
mkdir -p ~/hg/repos
 
vi ~/hg/hgweb.config
 
vi ~/hg/hgweb.config
 
[web]
 
[web]
−
style = gitweb
+
style = gitweb</code>
  
 +
<code>
 
cp ~/sources/mercurial-1.8.2/hgweb.cgi ~/hg
 
cp ~/sources/mercurial-1.8.2/hgweb.cgi ~/hg
 
chmod +x ~/hg/hgweb.cgi
 
chmod +x ~/hg/hgweb.cgi
 
vi hgweb.cgi
 
vi hgweb.cgi
 
config = “[HOME]/hg/hgweb.config”
 
config = “[HOME]/hg/hgweb.config”
−
import sys; sys.path.insert(0, “[HOME]/lib/python”)
+
import sys; sys.path.insert(0, “[HOME]/lib/python”)</code>
  
 +
<code>
 
vi ~/hg/.htaccess
 
vi ~/hg/.htaccess
 
# Taken from http://www.pmwiki.org/wiki/Cookbook/CleanUrls#samedir
 
# Taken from http://www.pmwiki.org/wiki/Cookbook/CleanUrls#samedir
Zeile 570: Zeile 603:
 
RewriteCond %{REQUEST_FILENAME} !-f # Send requests for directories that exist to those directories.
 
RewriteCond %{REQUEST_FILENAME} !-f # Send requests for directories that exist to those directories.
 
RewriteCond %{REQUEST_FILENAME} !-d # Send requests to hgweb.cgi, appending the rest of url.
 
RewriteCond %{REQUEST_FILENAME} !-d # Send requests to hgweb.cgi, appending the rest of url.
−
RewriteRule (.*) hgweb.cgi/$1 [QSA,L]
+
RewriteRule (.*) hgweb.cgi/$1 [QSA,L]</code>
  
 
Now we have everything! To have it linked to a domain, do:
 
Now we have everything! To have it linked to a domain, do:
Zeile 576: Zeile 609:
 
ln -s ~/hg ~/[Sub domain]
 
ln -s ~/hg ~/[Sub domain]
 
-->
 
-->
 +
 +
[[Kategorie:Installationen]]
 +
[[Kategorie:English pages]]

Aktuelle Version vom 25. August 2022, 19:08 Uhr

Solutions for installing mercurial from a package repository or via a self-extracting or any other installer can easily be found for all operating system distributions. Thus this is not the topic of this Wiki entry. Here we cover the installation of a mercurial versioning system without root access. It is a necessary step for the creation of our symbiotic open source hard and software development system that at a later point shall be mirrored by the Wiki to keep it up to date automatically and at all times. This allows us to bundle our efforts for development in our versioning system (I use mercurial, but git, svn, bzr, ... will be fine too).

In the following the process of how we got mercurial working on our webspace (we don't own a server due to financial reasons) is documented. A lot of special information is added in the second chapter that is nice to know, but as it turned out this did not work for us.

So the only really relevant part is the Chapter: Our solution (what finally worked for us). If you want to know something about why the first undertakings did fail read all chapters, but I warn you, it's messy. Hence it's probably better to read the excerpt of problems that occurred for us instead.


With a Python installation readily available or with rights to install a python environment:

It's also no problem, if a python installation is available or you have a server where you have adminsitrative rights (root access) for installing a python environment and still want to have a local installation of mercurial into your home directory. It is recomended to use the Mercurial script: make install-home (to include documentation) or make install-home-bin (for the executable only). If you used a custom python location for the script it is required to add the following to the command to communicate it to hg:

$ PYTHON=/path/to/python2.7-or-newer #this will be supported for a long time

$ make install-home

Source: http://mercurial.selenic.com/wiki/UnixInstall#Per-user_installation

Continue with Chapter: Configure Mercurial for a Python installation.


Without Root access and no Python available:

To install mercurial without being root, needs us to bundle Python 2.x (as Python 3 is not yet supported as there is only one advantage in favour of upgrading, so it's not worth the effort currently).

Windows

For Windows there currently is PortablePython as a ready made option. But you have to ensure that the header python-dev files are available. Otherwise it will not work. We have not tested this route as we consider Linux (Open source & non-profit, btw Mac OS is also essentially Linux, just like Android) our friend while Windows (Closed source & commercial) as our ... well, is enemy the correct word? I don't know.


UNIX/POSIX

For UNIX systems (Mac OS, GNU/Linux, Android, ...) or FreeBSD there are some packages floating around in the net, but it's sometimes hard to find the correct one for a certain architecture and operating system (what is needed to match the server's arch and os).

So if you have a system similar to the web server available where you have root access, the following is an option of how to get a working mercurial and python.

Virtual / bundled installation of Python

To create a virtual/bundled installation of Python and Mercurial there are two or more quite similar ways.

We will proceed in adapting this splendid blog entry of Fabrizio: https://weblogs.java.net/blog/fabriziogiudici/archive/2009/07/installing_merc.html .

$ cd $HOME #cd ~ also works


$ sudo apt-get install python2.7 python2.7-dev #if unmet dependencies problem occurs see below


$ wget peak.telecommunity.com/dist/virtual-python.py #if it can't be resolved, search the web for virtual-python.py .


$ export PYTHONPATH=$HOME/python2.7/lib/python2.7/site-packages/


$ python2.7 </path/to/>virtual-python.py --prefix=$HOME/python2.7/ #Note: This in conjunction with the following command copies the python files to the specified path in the $HOME directory!

Because of cd $HOME in our case it becomes: $ python2.7 ./virtual-python.py --prefix=$HOME/python2.7/


$ python2.7 ./virtual-python.py --prefix=$HOME/python2.7/


Two possibilities: Setuptools complete for creation of virtual python or - how we did it - only fetch the relevant part of setuptools package: (if another python version is required look here for the .egg file):

$ wget https://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11-py2.7.egg


I figured that one command was missing to get a successful install:


$ chmod +x ./setuptools-0.6c11-py2.7.egg


Now make sure that the PYTHONPATH is pointing to the correct python directory: $HOME/python2.7/lib/python2.7/site-packages/ . Check it using: echo $PYTHONPATH (If it's not correct, once again: export PYTHONPATH=$HOME/python2.7/lib/python2.7/site-packages/.


Then install easy_install binaries et alia using:

$ ./setuptools-0.6c11-py2.7.egg --prefix=$HOME/python2.7/


(Note that this is a required step - it must not fail! Check the terminal output.)



$ python2.7/bin/easy_install-2.7 --prefix=$HOME/python2.7/ mercurial


Change the rights of all types (user[read:owner], group, other) at once:

$ find python2.7 -type d | xargs chmod a+rx


Ensure files loose write permissions:


$ find python2.7 -type f | xargs chmod a+r


Avoid this: Bundle Mercurial and Python

This is only required if no compiler on target host/server and if using make install-home-bin is impossible and all other make install fail.

$ tar -cvzhf mercurial.tar.gz python2.7/ #compress, verbose, z: use gzip2, h: dump files that symbolic links point to instead of using the symbolic link, files, -C or --directory <target_directory>; if you have compatibility issues omit the '-' after the tar or use another archiver like 'pax' which is standard-compliant. tar might well come from times where dinosaurs were around. ; )


Remove no longer needed temporary files if desired: $ rm -rf python2.7 setuptools-0.6c11-py2.7.egg virtual-python.py #f: force : ignore non-existant files, never prompt. (so non-interruptable)


Alternatively:


$ mkdir mercurial_python_creation/ && mv mercurial.* mercurial_python_creation/ && mv virtual_python.py mercurial_python_creation/ && mv python2* mercurial_python_creation/


Upload to server

$ scp ~/mercurial.tar.gz <user>@<server>:mercurial.tar.gz


Eventually accept and store the server key footprint. Enter password and extract the uploaded file remotely via a shell session.


$ ssh <user>@<server>


Setting up virtual python installation

$ cd $HOME && tar -xzf mercurial.tar.gz #attention the resulting folder is python<version> in place of mercurial


Check for hg in the binary folder:


$ ls -a mercurial/bin/ # -a for all files (including hidden ones)

$ cd $HOME/python2.7/


Create wrapper shell script: Insert lines:

#!/bin/sh

export PYTHONPATH=$(HOME)/python-dev/lib/python2.7/site-packages

$(HOME)/python-dev/bin/hg "$@"

Now point the server to the script (via .bashrc or .bash_profile I guess?). Fabrizio also edited vi ~/python-dev/bin/hg so the "dang bash" line is #!$(HOME)/python-dev/bin/python in place of #!/usr/bin/python. He says, it just worked.



Configure Mercurial for a Python installation:

$ wget http://mercurial.selenic.com/release/mercurial-2.8.tar.gz

$ scp ~/mercurial-2.8.tar.gz <user>@<server>:mercurial-2.8.tar.gz

Log on to the server. (see above)

Extracting into a folder requires this folder to already exist! (so then don't omit this step). We chose 'mercurial' as the target directory:

$ mkdir mercurial #alternatively call it 'hg'


Unpack the downloaded mercurial package:

$ tar -xzf mercurial-2.8.tar.gz --directory mercurial # -C is a synonym=alias for --directory

$ cd $HOME/<mercurial_extracted_folder>/


now

EITHER

$ make PYTHON=$HOME/python2.7/bin/python PREFIX=/usr/local/ install-home-bin

$ hg # should show version

OR

$ make PYTHON=$HOME/python2.7/bin/python local # build for inplace usage (only within current folder) and only if a compiler is available.

$ ./hg --version # should show the latest version


Now continue with Sub-Chapter: Make Python and Mercurial commands available (ease of use).


Alternative: VirtualEnv[ironment]

The third entry from top: http://stackoverflow.com/questions/11249901/creating-a-portable-python-local-install-for-linux



Problems that might occur (and occurred for me)

If a 'dependency unmet' error occurs when trying to install python2.7-dev then follow the solution I proposed in this thread: 

1. sudo apt-get install aptitude
2. sudo aptitude install python2.7-dev
3. skip first proposed solution [Not installed] and wait for the next solution to be proposed:
4. take the solution to downgrade the dependencies.

Also a bunch of i386 programms will propably be removed during the process. (just trust Linux!)

Another severe problem and showstopper was that there are different mercurial versions around ... some of them use 4byte string representation instead of the common type of 2byte (As also using .tgz ending mercurial files did not stop errors I settled on a trick, see below:)

$ sudo apt-get source mercurial #called from $HOME

This made me feel strange once again, but at least this resolved the python issues.

The next problem was a old the python header files were missing once again. So that is a strong indicator of missing installation of python<version>-dev package on the target system (server in our case).

Just another trick helped resolve this: A bundled python or PortablePython as long as PortablePython has the header files included! And that may be uncertain.

For the bundled python solution see above: marked as obsolete, but now it no longer is. (- :

It's embarassing. There are plenty of libraries that mercurial needs missing now in the python installation. For yet another trick to solve this, see next chapter.



Our solution (what we ended up with):

As more and more problems occurred, I decided to split up the problem. So now all efforts went into first installing Python into a home directory and that works quite fluently, but the question was if all libraries were available - And they weren't! :/

With root access this all had not been problematic as the root problem were missing python-dev header files. So we had to grab the problem at its root and hence compiled our own python into our target $HOME directory.

This resolved the header problems. But when trying to install mercurial it complained once more - this time about missing bz2 which mercurial needs to compress files for versioning.

Of course the obvious solution is to fetch the sources for libbz2 but that left us with several other error messages as it is easily forgotten to copy the library (.so) file to $HOME/lib/ directory. For buliding a library .so file we also need yet another trick: using the alternative Makefile. So here go all the commands that finally succeeded:


On the local machine - that has to be almost identical to the remote target - issue the the following commands:

$ cd $HOME && sudo apt-get install python2.7 python2.7-dev && sudo apt-get source python2.7 python2.7-dev

$ scp $HOME/python2*.t* <user>@<target_remote>: #it's essentially a wget <python-dev-sources>


Fetch sources for Mercurial.

Change to the remote machine via ssh <user>@<target_remote> and enter:

$ wget http://mercurial.selenic.com/release/mercurial-2.8.tar.gz

$ tar -xf mercurial-2.8.tar.gz && mv mercurial-2.8 mercurial #if no error message is shown, everything went fine, omit the last command if desired.


Fetch missing library sources

$ wget http://www.bzip.org/1.0.5/bzip2-1.0.5.tar.gz && tar -xf bzip2-1.0.5.tar.gz && mv bzip2-1.0.5 bzip2 && cd bzip2


Don't forget to overwrite the PREFIX otherwise it will point to /usr/local and there we don't have access to! So:

$ export PYTHONPATH=$HOME/lib/python2.7/dist-packages/ && export PREFIX=$HOME

$ make -f Makefile-libbz2_so # build the library

$ make # build the library

$ make PREFIX=$HOME install

$ cp libbz2.so.1.0.4 $HOME/lib/libbz2.so.1.0.4 # make the library available in the general home lib path (so that it can be found)!

$ ln -s $HOME/lib/libbz2.so.1.0.4 $HOME/lib/libbz2.so.1.0 # in case applications try to find version *.so.1.0 instead of *.so.1.0.x


Resume the Python installation:

If you did not go the scp route as shown at the beginning of this chapter, then make sure you get the python<version>-dev packages! Otherwise header files will be missing. $ cd ~ && tar -xf <python-dev>.tar.gz && mv <python-dev> python-dev && cd python-dev


Now we have 'mercurial' and 'python-dev' directories and have changed our pwd (parent working directory) to the latter.

$ ./configure --prefix=$HOME && make # "We should not see bz2 on the not-built-module list now!" But don't worry, we will see it anyway in the next step. If we get no error concerning libbz2.so then all is fine!

$ make PREFIX=$HOME install

$ which python && $HOME/bin/python # Show which version is on the path and confirm our $HOME version works.

Now if we try to install mercurial, it might complain about missing docutils. So let's adapt another trick and install 'docutils' using 'easy_install', hence using setuptools.


Setuptools - Install docutils.

Fetch the relevant part of setuptools package: (if another python version is required look here for the .egg file):

$ wget https://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11-py2.7.egg

I figured that this command was missing to make sure we get a successful install: $ chmod +x ./setuptools-0.6c11-py2.7.egg # make it executable Now make sure that the PYTHONPATH is pointing to the correct python directory: $HOME/python2.7/lib/python2.7/site-packages/ . Check it using: echo $PYTHONPATH (If it's not correct, once again: export PYTHONPATH=$HOME/python2.7/lib/python2.7/site-packages/.


Then install easy_install binaries et alia using: $ ./setuptools-0.6c11-py2.7.egg --prefix=$HOME/python-dev/


$ ~/bin/easy_install docutils


Finish python installation

$ cd ~/python-dev/ && make altinstall prefix=$HOME exec-prefix=$HOME

$ ln -s ~/bin/python2.7 ~/bin/python # if python not already exists we add it as a symbolic link


Resume Mercurial installation.

Install mercurial and test it: If basic command list is shown, that'd be brilliant.

$ cd <mercurial-sources-dir> && make PYTHON=$HOME/bin/python install-home-bin && ~/bin/hg


Make python and hg commands available:

As the target server probably does have another installation of python in /usr/bin we want to overwrite the python command to automatically use the correct one [the one we installed ourselves]. So we append an alias to the .bashrc and .bash_profile that should get executed on ssh login too. Also we make the hg command available in our $HOME directory and all directories below included.

If .bashrc and .bash_profile not exist, create them:

If the files .bashrc and .bash_profile don't exist yet in $HOME directory - check it via ls -a $HOME - then use vi ~/.bashrc and type 'i' key for insert mode and insert #!/bin/sh. Then leave the Insert mode via ESC and save the file by typing :wq.

As an alternative:

$ touch ~/.bashrc && echo "#!/bin/sh" >> ~/.bashrc


$ touch ~/.bash_profile && echo "#!/bin/sh" >> ~/.bash_profile


Create alias:

$ echo "alias python='~/bin/python'" >> ~/.bashrc && echo "alias python='~/bin/python'" >> ~/.bash_profile && echo "alias hg='~/bin/hg'" >> ~/.bashrc && echo "alias hg='~/bin/hg'" >> ~/.bash_profile

The .hgrc file it used for defining exceptions and other settings. See this splendid [url=http://cgcookie.com/blender/2013/08/20/using-mercurial-version-control-with-blender-projects/]blender instructional mercurial video[/url] of Sebastian König.

$ '#mercurial setup\r\nexport HGRCPATH=$(HOME)/.hgrc' >> ~/.bash_profile && source ~/.bash_profile



Done - Follow the mercurial introduction.

Now follow the blender example tutorial a bit. You can omit the blender file manipulation and you will still learn a lot by simply following along and creating your own repository out of any files. Or you just start by navigating to your project folder via $ cd $HOME/<project_folder_within_home_including_below> and typing $ hg init and then hg for getting help or just $ hg add * to add files and hg commit for your first commit to check in where you start. Once you have changed something substantially and think it's required to go back to this version - e.g. because it's working and you plan a bigger change that probably breaks things - then just $ hg commit from within the project directory. Now have fun. : -)







Sources

Abgerufen von „https://wiki.opensourceecology.de/index.php?title=Mercurial_(hg)_Installation_Without_Being_Root&oldid=23382“