summaryrefslogtreecommitdiffstats
path: root/archiva-docs/src/site/apt/adminguide/upgrade.apt
blob: f1a664303eb0f267f92eefb4cbd4c9a420b5a6a0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
 ------
 Upgrading Archiva
 ------

Upgrading Archiva

   Upgrading Archiva is straightforward if the directions for separating the base from the installation above are followed. Simply retain the <<<data/repositories>>> and <<<data/databases/users>>> directories,
   and the configuration files (in the conf directory, or the other locations specified above) and use a new extracted installation of Archiva.

   Note that the <<<users>>> database must always be retained as it contains the permissions and user information across versions. However,
   in order to take advantage of the improvements in search in Archiva 1.1 (and higher versions), s.a. search by java class/package/method, the archiva database must
   be re-created. So you need to delete the <<<data/databases/archiva>>> directory, delete the <<<.index>>> directories of your respective repositories, and execute the repository and database scanners after
   starting Archiva.

   The repository data is portable across versions, and multiple versions can be configured to look at the same repositories (though not run simultaneously).

* Upgrading Archiva from 1.1.x to 1.2.x

   Because of the changes in the search implementation starting in 1.2, a few additional steps need to be performed when upgrading Archiva from 1.1.x to
   1.2.x. Since the format of the index has changed in 1.2.x, the old index directory (which is located at <<</path/to/repo/.index>>> by default) needs to
   be removed. And in order for the artifacts in the repository to be indexed again, the last modified date of the artifacts need to be updated.
   To do this, just execute <<find [REPOSITORY_DIRECTORY_NAME] | xargs touch>> at the base directory where the repository resides. Execute the repository
   scanning so that the new index will be generated.

   In 1.2.2, the length of the specified fields in the database tables below were changed to 1020:
   
   * ARCHIVA_PROJECT - URL

   * ARCHIVA_MAILING_LISTS - MAIN_ARCHIVE_URL

   * ARCHIVA_ORGANIZATION - URL, FAV_ICON_URL

   * ARCHIVA_LICENSES - URL

   * ARCHIVA_ISSUE_MANAGEMENT - ISSUE_MANAGEMENT_URL

   * ARCHIVA_CIMANAGEMENT - CI_URL

   * ARCHIVA_INDIVIDUAL - URL, ORGANIZATION_URL

   * ARCHIVA_DEPENDENCY - URL

   * ARCHIVA_SCM - SCM_URL, DEVELOPER_CONNECTION, URL

   * ARCHIVA_PROJECT_REPOSITORIES - URL
 
   []

   If upgrading from a version lower than 1.2.2, you might also need to alter the lengths of the above fields as there is no upgrade task currently available for this.