summaryrefslogtreecommitdiffstats
path: root/src/site/upgrade_go.mkd
diff options
context:
space:
mode:
authorJames Moger <james.moger@gitblit.com>2013-07-03 21:35:02 -0400
committerJames Moger <james.moger@gitblit.com>2013-07-03 21:35:02 -0400
commit8c99a7929b48b4c4a33c80d0b6646f6e6bb563b5 (patch)
treef0cce1420e9196339c612c2994d393455a23d365 /src/site/upgrade_go.mkd
parent5c5b7a8659851abc6ce1654414ceeef2e7f9c803 (diff)
downloadgitblit-8c99a7929b48b4c4a33c80d0b6646f6e6bb563b5.tar.gz
gitblit-8c99a7929b48b4c4a33c80d0b6646f6e6bb563b5.zip
Documentation
Diffstat (limited to 'src/site/upgrade_go.mkd')
-rw-r--r--src/site/upgrade_go.mkd42
1 files changed, 42 insertions, 0 deletions
diff --git a/src/site/upgrade_go.mkd b/src/site/upgrade_go.mkd
new file mode 100644
index 00000000..cd516015
--- /dev/null
+++ b/src/site/upgrade_go.mkd
@@ -0,0 +1,42 @@
+## Upgrading Gitblit GO (1.2.1+)
+
+1. Unzip Gitblit GO to a new folder
+2. Set the *--baseFolder* argument to point to your old `data` folder
+3. Review and optionally apply any new settings as indicated in the [release log](releases.html) to `data/gitblit.properties`.
+
+In *nix systems or Windows Vista/7/8, there are other tricks you can play like symlinking the `data` folder or symlinking the GO folder.
+All platforms support the *--baseFolder* command-line argument.
+
+## Upgrading Gitblit GO (pre-1.2.1)
+1. Create a `data` folder and copy the following files and folders to it:
+ - **users.conf*
+ - **projects.conf** *(if you have one)*
+ - **gitblit.properties**
+ - **serverKeystore.jks**
+ - **serverTrustStore.jks**
+ - *certs** folder
+ - **git** folder
+ - **groovy** folder
+ - **proposals** folder
+ - and any other custom files (robots.txt, welcome/login markdown files, etc)
+ - then edit your `gitblit.properties` file and adjust the following settings:
+ - *git.repositoriesFolder* = ${baseFolder}/git
+ - *groovy.scriptsFolder* = ${baseFolder}/groovy
+ - *groovy.grapeFolder* = ${baseFolder}/groovy/grape
+ - *web.projectsFile* = ${baseFolder}/projects.conf
+ - *realm.userService* = ${baseFolder}/users.conf
+ - *web.robots.txt* = ${baseFolder}/robots.txt
+ - *federation.proposalsFolder* = ${baseFolder}/proposals
+ - *realm.ldap.backingUserService* = ${baseFolder}/users.conf
+ - *realm.redmine.backingUserService* = ${baseFolder}/users.conf
+ - *server.tempFolder* = ${baseFolder}/temp
+
+2. Unzip Gitblit GO to a new folder
+3. Copy your `data` folder and overwrite the folder of the same name in the just-unzipped version
+4. Review and optionally apply any new settings as indicated in the [release log](releases.html) to `data/gitblit.properties`.
+
+**NOTE:** You may need to adjust your service definitions to include the `--baseFolder data` argument.
+
+#### Upgrading Windows Service
+You may need to delete your old service definition and install a new one depending on what has changed in the release.
+