| commit | author | age | ||
| 17ae31 | 1 | ## Upgrading Gitblit WAR (1.7.0+) |
| JM | 2 | |
| 3 | The default `gitblit.properties` file has been split into two files: `gitblit.properties`, which is the recommended file for setting your configuration, and `defaults.properties` which are Gitblit's default settings. | |
| 4 | ||
| 5 | # Include Gitblit's 'defaults.properties' within your configuration. | |
| 6 | # | |
| 7 | # COMMA-DELIMITED | |
| 8 | # SINCE 1.7.0 | |
| 9 | include = defaults.properties | |
| 10 | ||
| 11 | Notice that the default settings are *included* by your `gitblit.properties` file. The disadvantage to this approach is you must flip between discovering/reading the settings in `defaults.properties` and setting them in `gitblit.properties`, but there are some clear advantages too. This setup is not required. You may continue to keep all your settings in `gitblit.properties` like before. | |
| 12 | ||
| 13 | Additionally you may find it useful if you are maintaining several Gitblit instances to share common properties files. | |
| 14 | ||
| 15 | ## Upgrading Gitblit WAR (1.4.0+) | |
| 16 | ||
| 17 | The *baseFolder* context parameter has been replaced with a *baseFolder* JNDI env-entry. This means you can define the *baseFolder* from the administrative console of your servlet container and not have to manipulate anything in the web.xml file. | |
| 18 | ||
| 8c99a7 | 19 | ## Upgrading Gitblit WAR (1.2.1+) |
| 6c4be1 | 20 | 1. Make sure your `WEB-INF/web.xml` *baseFolder* context parameter is not `${contextFolder}/WEB-INF/data`! |
| 8c99a7 | 21 | If it is, move your `WEB-INF/data` folder to a location writeable by your servlet container. |
| JM | 22 | 2. Deploy new WAR |
| 23 | 3. Edit the new WAR's `WEB-INF/web.xml` file and set the *baseFolder* context parameter to your external baseFolder. | |
| 24 | 4. Review and optionally apply any new settings as indicated in the [release log](releases.html) to `${baseFolder}/gitblit.properties`. | |
| 25 | ||
| 26 | ## Upgrading Gitblit WAR (pre-1.2.1) | |
| 27 | ||
| 28 | 1. Create a `data` as outlined in step 1 of *Upgrading Gitblit GO (pre-1.2.1)* | |
| 29 | 2. Copy your existing web.xml to your data folder | |
| 30 | 3. Deploy new WAR | |
| 31 | 4. Copy the new WAR's `WEB-INF/data/gitblit.properties` file to your data folder | |
| 32 | 5. Manually apply any changes you made to your original web.xml file to the gitblit.properties file you copied to your data folder | |
| 33 | 6. Edit the new WAR's `WEB-INF/web.xml` file and set the *baseFolder* context parameter to your external baseFolder. | |
