From 5381dbb2da30f2883c507ff352d66f779f0ca8be Mon Sep 17 00:00:00 2001 From: Sitaram Chamarty Date: Tue, 14 Jun 2011 20:18:50 +0530 Subject: [PATCH] (doc) upgrading a 'from-client' installation to 'non-root' --- doc/1-INSTALL.mkd | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/doc/1-INSTALL.mkd b/doc/1-INSTALL.mkd index 5c70ce1..6b4c793 100644 --- a/doc/1-INSTALL.mkd +++ b/doc/1-INSTALL.mkd @@ -11,6 +11,7 @@ In this document: * package method * root method * non-root method + * upgrading from from-client method to non-root method * troubleshooting * important points to note * naming conventions used @@ -170,6 +171,38 @@ On your *workstation*: git clone git@server:gitolite-admin + + +##### upgrading from from-client method to non-root method + +Since the from-client method is now deprecated for reasons explained +elsewhere, some folks may want to do their next upgrade using the non-root +method. + +There are many, many ways to skin this cat; here's one way: + + * follow non-root install but stop after the gl-system-install step + + * temporarily rename your `~/.gitolite.rc` file to something else + + * now run the gl-setup step + + (background: this will create a default rc file with default values, but + crucially, it will give you the correct values for two very critical + variables that are not used in the old from-client install method) + + * edit `~/.gitolite.rc` and bring in any non-default settings you may have + had in your old rc file. + + When you're done, the only difference between your old and current rc + files should be that the `$GL_PACKAGE_CONF` and the `$GL_PACKAGE_HOOKS` + variables are no longer commented out and look somewhat like this: + + $GL_PACKAGE_CONF = '/home/git/share/gitolite/conf'; + $GL_PACKAGE_HOOKS = '/home/git/share/gitolite/hooks'; + + Now save the file. + ----