dps: made dps section clearer and more step-by-step

This commit is contained in:
Sitaram Chamarty 2010-03-12 10:24:53 +05:30
parent 7588c8cf54
commit d660822ab5

View file

@ -284,33 +284,50 @@ can be, say, `/usr/share/gitolite/conf` or some such, and similarly location
"Y" can be perhaps `/usr/share/gitolite/hooks`. It's upto your distro "Y" can be perhaps `/usr/share/gitolite/hooks`. It's upto your distro
policies where they are. policies where they are.
These are the content changes needed (no trailing slashes in the location **Step 1**: Clone the gitolite repo and run the make command inside the clone
values please):
* `gl-setup` should have the following line: git clone git://github.com/sitaramc/gitolite.git
cd gitolite
make pu.tar # or "make master.tar" or "make v1.2.tar" etc
Then you explode the tar file in some temporary location.
*Alternatively, you can `git checkout` the tag or branch you want, and run
this command in the clone directly*:
git describe --tags --long > conf/VERSION
**Step 2**: Now make the following changes (no trailing slashes in the
location values please):
* `src/gl-setup` should have the following line:
GL_PACKAGE_CONF="X" GL_PACKAGE_CONF="X"
* `example.gitolite.rc` should have the following lines: * `conf/example.gitolite.rc` should have the following lines:
$GL_PACKAGE_CONF="X"; $GL_PACKAGE_CONF="X";
$GL_PACKAGE_HOOKS="Y"; $GL_PACKAGE_HOOKS="Y";
This is where the files should be installed: * delete `src/gl-easy-install`; that script is meant for a totally different
mode of installation and does *not* play well in this mode :-)
**Step 3**: Move (or arrange to move) the files to their proper locations as
given below:
* everything in "src" goes somewhere on the PATH * everything in "src" goes somewhere on the PATH
* everything in "conf" goes to location "X" * everything in "conf" goes to location "X"
* everything in "hooks" goes to location "Y" * everything in "hooks" goes to location "Y"
You might also want to delete the `gl-easy-install` script, since that is **Step 4**: There is no step 4. Unless you count telling your users to run
meant for a totally different mode of installation and probably would *not* `gl-setup` as a step :)
work if a user tried to run it :-)
On the initial install, you could also choose to setup a userid called On the initial install (urpmi, yum install, or apt-get install), you could
"gitolite", and run "gl-setup" as that user; however I do not know how you also choose to setup a userid called "gitolite", and run "gl-setup" as that
would come up with the initial pubkey that is needed. Anyway, the point is user; however I do not know how you would come up with the initial pubkey that
that the "gitolite" user is no more special than any other in terms of hosting is needed. Anyway, the point is that the "gitolite" user is no more special
gitolite. Any user can host it by just running "gl-setup". than any other in terms of hosting gitolite. Any user can host gitolite on
his userid by just running "gl-setup".
When you upgrade, just overwrite all the files; it'll all just work. In fact, When you upgrade, just overwrite all the files; it'll all just work. In fact,
other than the initial "gl-setup" run, the only time a gitolite hosting user other than the initial "gl-setup" run, the only time a gitolite hosting user