James Moger
2014-05-12 edeab95cac16e5f17cfcd75a9969d8708bf360ab
commit | author | age
8c99a7 1 ## Upgrading Gitblit GO (1.2.1+)
JM 2  
3 1. Unzip Gitblit GO to a new folder
4 2. Set the *--baseFolder* argument to point to your old `data` folder
5 3. Review and optionally apply any new settings as indicated in the [release log](releases.html) to `data/gitblit.properties`.
6
7 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.
8 All platforms support the *--baseFolder* command-line argument.
9
10 ## Upgrading Gitblit GO (pre-1.2.1)
11 1. Create a `data` folder and copy the following files and folders to it:
6c4be1 12     - **users.conf**
8c99a7 13     - **projects.conf** *(if you have one)*
JM 14     - **gitblit.properties**
15     - **serverKeystore.jks**
16     - **serverTrustStore.jks**
6c4be1 17     - **certs** folder
8c99a7 18     - **git** folder
JM 19     - **groovy** folder
20     - **proposals** folder
21     - and any other custom files (robots.txt, welcome/login markdown files, etc)
22     - then edit your `gitblit.properties` file and adjust the following settings:
23         - *git.repositoriesFolder* = ${baseFolder}/git
24         - *groovy.scriptsFolder* = ${baseFolder}/groovy
25         - *groovy.grapeFolder* = ${baseFolder}/groovy/grape
26         - *web.projectsFile* = ${baseFolder}/projects.conf
27         - *realm.userService* = ${baseFolder}/users.conf
28         - *web.robots.txt* = ${baseFolder}/robots.txt
29         - *federation.proposalsFolder* = ${baseFolder}/proposals
30         - *realm.ldap.backingUserService* = ${baseFolder}/users.conf
31         - *realm.redmine.backingUserService* = ${baseFolder}/users.conf
32         - *server.tempFolder* = ${baseFolder}/temp
33
34 2. Unzip Gitblit GO to a new folder
35 3. Copy your `data` folder and overwrite the folder of the same name in the just-unzipped version
36 4. Review and optionally apply any new settings as indicated in the [release log](releases.html) to `data/gitblit.properties`.
37
38 **NOTE:** You may need to adjust your service definitions to include the `--baseFolder data` argument.
39
40 #### Upgrading Windows Service
41 You may need to delete your old service definition and install a new one depending on what has changed in the release.
42